Home

PIWIGO Navigatie

 

Piwigo::Upgrades

Procedure van de Upgrade naar Pwigo versie 12.0

De upgrade van Piwigo van versie 11.5.0 naar versie 12.0 bevatte meerdere wijzigingen en er word gewaarschuwd met de nodige zorg te werk te gaan en te zorgen voor een goede backup in het geval zich ernstige problemen voor zouden doen.
Van verschillende door mij gebruikte plugins is tevens nog niet onderzocht of deze inmiddels al compatible zouden zijn met versie 12.0.

Van de upgrade procedure hieronder de door mij uitgevoerde stappen.

Naar index

1. Backup version 11.0

Maak een volledige Piwigo backup met het script #utils zoals uiteengezet in Piwigo::Backup

Deze backup wordt middels een cron dagelijks uitgevoerd en opgeslagen in /vault/piwigo/ en als dit zou gebeuren halverwege het upgrade proces worden de pre-upgrade data mogelijk (gedeeltelijk) overschreven.
Maak daarom voordat met de upgrade begonnen wordt een backup en kopiëer /vault/piwigo/* naar een tijdelijke map bijvoorbeeld /vault/piwigo/piwigo-11_5_0-preupgrade/.
Kopiëer alles behalve het fotobestand /vault/piwigo/pwgdata/galleries

2. Upgrade naar versie 12.0

  1. Voer de Piwigo upgrade uit:
    Alle thema's anders dan Elegant en plugins worden gedeactiveerd.
  2. Met de upgrade worden ook alle eigen lokale sjablonen ontkoppeld.
    Koppel deze opnieuw in Beheer > Configuratie > Sjablonen
    Note:
    Na de upgrade naar V12.0 was bovenstaande menuoptie niet meer beschikbaar. Corrigeer deze bug door in de LocalFiles Editor > Lokale Configuratie toe te voegen: $conf['show_template_in_side_menu'] = true;
  3. Er zijn geen upgrades van geïnstalleerde thema's, zowel thema Elegant als Smartpocket zijn compatible met Piwigo versie 12.0
  4. Voer individuele upgrades van de plugins uit.
    Meeste plugins blijken (nog) niet compatible met Piwigo versie 12.0
    Note:
    Na de upgrade naar V12.0 werkte Beheer > Plugins > Update niet meer. Zie het Piwigo Forum topic 31587 voor de (tijdelijke) oplossing.

Naar index

3. Re-activeer thema's in V12.0

  1. Maak Elegant Standaard
  2. Verifieer dat parent thema Smartpocket geïnstalleerd is en activeer eigen child thema MyMobile

4. Re-activeer plugins in V12.0

  1. Advanced Menu Manager (Niet compatible?)
    Heeft Grum Plugins Classes.3 nodig.
    Werkt goed. Instellen verifiëren als per Piwigo::Plugins - Advanced Menu Manager
  2. Batch Downloader (Niet compatible?)
    Werkt goed.
    Voeg groep 'sharealbum' toe als per Piwigo::Plugins - Share Album
  3. Dynamic Recent Period (Niet compatible ?)
    Werkt goed. Geen hacks. Verifieer instellingen als per Piwigo::Plugins - Dynamic Recent Period
  4. Exif View (Niet compatible ?)
    Werkt goed. Geen verdere instellingen mogelijk. Geen hacks
  5. Extended Description (compatible met 12.0)
    Geen verdere instellingen nodig. Geen hacks
  6. Fotorama (Niet compatible ?)
    Werkt goed. Verifieer instellingen als per Piwigo::Plugins - Fotorama
    Met een upgrade van Fotorama zelf zullen zelfgemaakte hacks overschreven worden!
  7. Grum Plugins Classes.3 (compatible met 12.0)
    Geen verdere instellingen nodig.
  8. LocalFiles Editor (compatible met 12.0)
    Alle Local Files zijn opgeslagen in ../piwigo/local/ en worden met een upgrade/update ongemoeid gelaten.
  9. Personal Plugin (compatible met 12.0)
    Instellingen worden gemaakt in de Local Files Editor onder tab Personal Plugin
    Alle Local Files zijn opgeslagen in ../piwigo/local/ en worden met een upgrade/update ongemoeid gelaten.
  10. Posted Date Changer(Niet compatible ?)
    Werkt goed. Geen verdere instellingen mogelijk.
    Is beschikbaar in de Foto Bulkbeheerder als actie optie 'Verander de plaatsingsdatum'
  11. PWG Stuffs(Niet compatible ?)
    Werkt goed. Instellingen bewaard gebleven met upgrade.
  12. RightClick (Niet compatible ?)
    Werkt goed. Geen verdere instellingen mogelijk.
    Zie zonodig sectie Piwigo::Beveiliging
  13. Rotate Image(Niet compatible ?)
    Werkt goed. Geen verdere instellingen mogelijk.
    Is beschikbaar in de Foto Bulkbeheerder als actie optie 'Roteer (draai) foto's'
  14. RV Menu Tree (Niet compatible ?)
    Werkt goed Geen verdere instellingen mogelijk.
  15. ShareAlbum (compatible met 12.0)
    Alle instellingen en hacks zijn bewaard gebleven.
  16. Thumbnail Tooltip (Niet compatible ?)
    Werkt goed. Alle instellingen en hacks zijn bewaard gebleven.
    Maakt gebruik van lokale sjabloon ../piwigo/template-extension/elegant_thumbnails.tpl die niet overschreven wordt bij upgrades.
  17. VideoJS (Niet compatible ?)
    Werkt goed. Alle instellingen en hacks zijn bewaard gebleven.

Naar index

5. Check beveiliging

In de Exploring Linux sectie Piwigo::Beveiliging wordt extra beveiliging toegevoegd aan Piwigo.

De upgrade heeft geen gevolgen voor de eigen beveiliging.

Er worden verschillende maatregelen genomen om o.a. Originelen en Geschaalde afbeeldingen te beschermen.
Alle genomen veiligheidsmaatregelen worden genomen met code in de Local Files Editor en/of Apache Httpd configuratie bestanden.
Deze worden door de upgrade van Piwigo ongemoeid gelaten.

De plugin RightClick gebruikt om rechtsklikken-acties te blokkeren. Deze plugin is nog niet geconfirmeerd compatible met Piwigo 12.0 maar werkt goed.

Naar index

6. Check eigen lokale aanpassingen in V12.0

In de Exploring Linux secties Piwigo::Aanpassen Desktop Thema en Piwigo::Aanpassen Mobiel Thema zijn eigen wijzigingen gemaakt in de weergave van Piwigo.
Hierbij is voor het thema Elegant zo veel mogelijk gebruik gemaakt van de Local Files Editor met o.a. de secties Lokale configuratie, CSS en Sjablonen.
Het mobile thema Smartpocket is aangepast door het lokaal maken van een child thema MyMobile.
Al deze wijzigingen worden opgeslagen buiten de Piwigo core en worden bij een upgrade niet gewijzigd of overschreven.

Er zijn echter wijzigingen aangebracht waarvoor core-bestanden van thema's en/of plugins gehackt moesten worden.
Bij een upgrade moeten al deze hacks gecheckt worden en zonodig opnieuw aangebracht worden

Naar index

6. Check en herinstalleer HACKS in V12.0

Als hacks gemaakt zijn worden deze mogelijk bij een update/upgrade overschreven als het bestand waarin ze gemaakt zijn vernieuwd wordt.
Omdat veelal niet duidelijk is welke bestanden vernieuwd zijn, moeten we alle gemaakte hack nalopen.

Bij de bestanden waarin we hacks maken hanteren we het volgende protocol:

Als na een upgrade het bestand xx dat een hack bevatte een recentere timestamp heeft dan het xx.bck bestand betekent dit dat de hack overschreven is.
Met het linuxscript UTILS > Backup > Piwigo Backup > Piwigo User-Hacks Backup > Check 'piwigo-hacks' na een Piwigo update/upgrade op overschrijving is snel te checken bij welke hacks dit het geval is.
Vervolgens onderzoeken we met het Windows programma ExamDiff of het nieuwe bestand xx een wijziging inhoudt t.o.v. het xx.org bestand.
Als dat niet het geval is dan kopiëren we xx en slaan deze op als de nieuwe xx.org. Vervolgens zetten we de hack terug met een kopie van het xx.bck bestand.
Als echter het nieuwe bestand xx wel verschilt met het xx.org bestand dan moeten we het nieuwe bestand xx bewerken, maar maken eerst een nieuwe xx.org kopie van xx. Vervolgens bewerken we het xx bestand en voegen de hack(s) weer toe en maken als laatste we hiervan een nieuwe xx.bck kopie.

Op 10 november 2021 hebben we de volgende bestanden met een hack, die al dan niet overschreven werden met de upgrade naar Piwigo 12.0:

Bestandsnaam Re-hack? Referentie
../index.php Ja met kopie index.pgp.bck Include naar ../include/extra-index.inc.php
../include/extra-index.inc.php Nee

Extra Cookie als gebruiker ingelogd is
Login smartpocket/mymobile
../admin/site_update.php Ja met kopie site_update.php.bck Synchronisatie-dialoog standaard instellingen
../include/user.inc.php Ja met edit Logout redirect en Drop cookie
../include/category_default.inc.php Ja met kopie category_default.inc.php.bck Standaard fotoformaat in albumpagina naar xsmall
../plugins/Fotorama/template/fotorama-content.tpl Nee Fotorama caption van 'naam' naar 'comment'
../plugins/Fotorama/fotorama/fotorama@2x.png Nee Ikonen bewerken
../plugins/PWG_Stuffs/theme/template/stuffs_logon.tpl Nee PWG-Stuffs loginblok aanpassen
../plugins/BatchDownloader/template/images/zip.png Nee Ikonen bewerken
../plugins/piwigo-videojs/template/vjs-5-player.tpl Nee Autoplay werkt niet met audio
../plugins/piwigo-videojs/video-js-5/videojs-local.css Nee Skin aanpassingen met lokale CSS
../plugins/piwigo-videojs/video-js-5/videojs-local-mobile.css Nee Skin aanpassingen met lokale CSS
../plugins/ShareAlbum/main.inc.php Nee ShareAlbum breadcrumb Accueil
../plugins/ShareAlbum/include/public_events.inc.php Nee ShareAlbum icon alleen op albums met foto's
../plugins/ShareAlbum/include/sharealbum_functions.inc.php Nee Sta download originele foto toe via configuratie
../plugins/ShareAlbum/admin/template/config.tpl Nee Sta download originele foto toe via configuratie
../plugins/ShareAlbum/admin/config.php Nee Sta download originele foto toe via configuratie
../plugins/rv_menutree/template/rv_menutree_categories.tpl Nee RV-Menutree per default uitklappen

Snelste methode voor het opnieuw invoegen van de hack(s):

Backup herstelde hacks
Ga op bovenstaande manier alle overschreven hacks langs en maak tot slot backup tarballs met script Backuppwg > piwigo-hacks

Naar index

Procedure van de Upgrade naar Pwigo versie 14.0

De upgrade van Piwigo naar versie 14.0 bevat meerdere wijzigingen en er wordt gewaarschuwd met de nodige zorg te werk te gaan en te zorgen voor een goede backup in het geval zich ernstige problemen voor zouden doen.
Van enkele door mij gebruikte plugins is tevens nog niet onderzocht of deze inmiddels al compatible zouden zijn met versie 14.0.

Van de upgrade procedure hieronder de door mij uitgevoerde stappen.

Naar index

1. Backup version 13.0

Maak een volledige Piwigo backup met het script #utils zoals uiteengezet in Piwigo::Backup

Deze backup wordt middels een cron dagelijks uitgevoerd en opgeslagen in /vault/piwigo/ en als dit zou gebeuren halverwege het upgrade proces worden de pre-upgrade data mogelijk (gedeeltelijk) overschreven.
Maak daarom voordat met de upgrade begonnen wordt een backup en kopiëer /vault/piwigo/* naar een tijdelijke map bijvoorbeeld /vault/piwigo/snapshot-van-backup-20231227/.
Kopiëer alles behalve het fotobestand /vault/piwigo/pwgdata/galleries

2. Upgrade naar versie 14.0

  1. Voer de Piwigo upgrade uit:
    Alle thema's anders dan Elegant en alle plugins worden gedeactiveerd.
  2. Met de upgrade worden ook alle eigen lokale sjablonen ontkoppeld.
    Koppel deze opnieuw in Beheer > Configuratie > Sjablonen
  3. Er zijn geen upgrades van geïnstalleerde thema's, zowel thema Elegant als Smartpocket zijn compatible met Piwigo versie 14.0
  4. Voer individuele upgrades van de plugins uit.
    Meeste plugins blijken compatible met Piwigo versie 14.0, zie volgende sectie 'Re-activeer plugins in V14.0'
Attentie: Na uitloggen is opnieuw inloggen niet mogelijk
Als er na de update per ongeluk uitgelogd wordt voordat alle plugins weer gereactiveerd zijn en/of eigen hacks nog niet hersteld zijn lukt inloggen niet.
Om het inlogscherm te openen gebruik de url: https://www.makkink.eu/piwigo/identification.php

Naar index

3. Re-activeer thema's in V14.0

  1. Maak Elegant Standaard
  2. Verifieer dat parent thema Smartpocket geïnstalleerd is en activeer eigen child thema MyMobile

4. Re-activeer plugins in V14.0

  1. Advanced Menu Manager (Niet compatible?)
    Heeft Grum Plugins Classes.3 nodig.
    Werkt goed. Instellingen zijn behouden, geverifiëerd als per Piwigo::Plugins - Advanced Menu Manager
  2. Batch Downloader (Compatible met 14.0)
    Werkt goed.
  3. Dynamic Recent Period (Niet compatible ?)
    Werkt goed. Geen hacks. Iinstellingen geverifieerd ongewijzigd als per Piwigo::Plugins - Dynamic Recent Period
  4. Exif View (Compatible met 14.0)
    Werkt goed. Geen verdere instellingen mogelijk. Geen hacks
  5. Extended Description (Niet compatible ?)
    Werkt goed. Geen verdere instellingen nodig. Geen hacks
  6. Fotorama (Compatible met 14.0)
    Werkt goed. Instellingen geverifieerd ongewijzigd als per Piwigo::Plugins - Fotorama
    Alleen met een upgrade van Fotorama zelf zullen zelfgemaakte hacks overschreven worden!
  7. Grum Plugins Classes.3 (Niet compatible?)
    Werkt goed. Geen verdere instellingen nodig.
  8. LocalFiles Editor (compatible met 14.0)
    Alle Local Files zijn opgeslagen in ../piwigo/local/ en worden met een upgrade/update ongemoeid gelaten.
  9. Personal Plugin (compatible met 14.0)
    Instellingen worden gemaakt in de Local Files Editor onder tab Personal Plugin
    Alle Local Files zijn opgeslagen in ../piwigo/local/ en worden met een upgrade/update ongemoeid gelaten.
  10. Posted Date Changer(compatible met 14.0)
    Werkt goed. Geen verdere instellingen mogelijk.
    Is beschikbaar in de Foto Bulkbeheerder als actie optie 'Verander de plaatsingsdatum'
  11. PWG Stuffs(compatible met 14.0)
    Werkt goed. Instellingen bewaard gebleven met upgrade.
  12. RightClick (compatible met 14.0)
    Werkt goed. Geen verdere instellingen mogelijk.
    Zie zonodig sectie Piwigo::Beveiliging
  13. Rotate Image(compatible met 14.0)
    Werkt goed. Geen verdere instellingen mogelijk.
    Is beschikbaar in de Foto Bulkbeheerder als actie optie 'Roteer (draai) foto's'
  14. RV Menu Tree (compatible met 14.0)
    Werkt goed Geen verdere instellingen mogelijk.
  15. ShareAlbum (compatible met 14.0)
    Alle instellingen en hacks zijn bewaard gebleven.
  16. Thumbnail Tooltip (compatible met 14.0)
    Werkt goed. Alle instellingen en hacks zijn bewaard gebleven.
    Maakt gebruik van lokale sjabloon ../piwigo/template-extension/elegant_thumbnails.tpl die niet overschreven wordt bij upgrades.
  17. VideoJS (compatible met 14.0)
    Werkt goed. Alle instellingen en hacks zijn bewaard gebleven.

Naar index

5. Check beveiliging

In de Exploring Linux sectie Piwigo::Beveiliging wordt extra beveiliging toegevoegd aan Piwigo.

De upgrade heeft geen gevolgen voor de eigen beveiliging.

Er worden verschillende maatregelen genomen om o.a. Originelen en Geschaalde afbeeldingen te beschermen.
Alle genomen veiligheidsmaatregelen worden genomen met code in de Local Files Editor en/of Apache Httpd configuratie bestanden.
Deze worden door de upgrade van Piwigo ongemoeid gelaten.

De plugin RightClick gebruikt om rechtsklikken-acties te blokkeren. Deze plugin is geconfirmeerd compatible met Piwigo 14.0 en werkt goed.

Naar index

6. Check eigen lokale aanpassingen in V14.0

In de Exploring Linux secties Piwigo::Aanpassen Desktop Thema en Piwigo::Aanpassen Mobiel Thema zijn eigen wijzigingen gemaakt in de weergave van Piwigo.
Hierbij is voor het thema Elegant zo veel mogelijk gebruik gemaakt van de Local Files Editor met o.a. de secties Lokale configuratie, CSS en Sjablonen.
Het mobile thema Smartpocket is aangepast door het lokaal maken van een child thema MyMobile.
Al deze wijzigingen worden opgeslagen buiten de Piwigo core en worden bij een upgrade niet gewijzigd of overschreven.

Er zijn echter wijzigingen aangebracht waarvoor core-bestanden van thema's en/of plugins gehackt moesten worden.
Bij een upgrade moeten al deze hacks gecheckt worden en zonodig opnieuw aangebracht worden

Naar index

6. Check en herinstalleer HACKS in V14.0

Als hacks gemaakt zijn worden deze mogelijk bij een update/upgrade overschreven als het bestand waarin ze gemaakt zijn vernieuwd wordt.
Omdat veelal niet duidelijk is welke bestanden vernieuwd zijn, moeten we alle gemaakte hack nalopen.

Bij de bestanden waarin hacks gemaakt hebben hanteren we na de update het volgende protocol:

Als na een upgrade het bestand xx dat een hack bevatte een recentere timestamp heeft dan het xx.bck bestand betekent dit dat de hack overschreven is.
Met het linuxscript UTILS > Backup > Piwigo Backup > Piwigo User-Hacks Backup > Check 'piwigo-hacks' na een Piwigo update/upgrade op overschrijving is snel te checken bij welke hacks dit het geval is.
Vervolgens onderzoeken we met het Windows programma ExamDiff of het nieuwe bestand xx een wijziging inhoudt t.o.v. het xx.org bestand.
Als dat niet het geval is dan kopiëren we xx en slaan deze op als de nieuwe xx.org. Vervolgens zetten we de hack terug met een kopie van het xx.bck bestand.
Als echter het nieuwe bestand xx wel verschilt met het xx.org bestand dan moeten we het nieuwe bestand xx bewerken, maar maken eerst een nieuwe xx.org kopie van xx. Vervolgens bewerken we het xx bestand en voegen de hack(s) weer toe en maken als laatste we hiervan een nieuwe xx.bck kopie.

Op 27 december 2023 hebben we de volgende bestanden met een hack, die al dan niet overschreven werden met de upgrade naar Piwigo 14.0:

Bestandsnaam Re-hack? Referentie
../index.php Ja met edit Include naar ../include/extra-index.inc.php
../include/extra-index.inc.php Nee

Extra Cookie als gebruiker ingelogd is
Login smartpocket/mymobile
../admin/site_update.php Ja met kopie site_update.php.bck Synchronisatie-dialoog standaard instellingen
../include/user.inc.php Ja met kopie site_update.php.bck Logout redirect en Drop cookie
../include/category_default.inc.php Ja met kopie category_default.inc.php.bck Standaard fotoformaat in albumpagina naar xsmall
../plugins/Fotorama/template/fotorama-content.tpl Nee Fotorama caption van 'naam' naar 'comment'
../plugins/Fotorama/fotorama/fotorama@2x.png Nee Ikonen bewerken
../plugins/PWG_Stuffs/theme/template/stuffs_logon.tpl Nee PWG-Stuffs loginblok aanpassen
../plugins/BatchDownloader/template/images/zip.png Nee Ikonen bewerken
../plugins/piwigo-videojs/template/vjs-5-player.tpl Nee Autoplay werkt niet met audio
../plugins/piwigo-videojs/video-js-5/videojs-local.css Nee Skin aanpassingen met lokale CSS
../plugins/piwigo-videojs/video-js-5/videojs-local-mobile.css Nee Skin aanpassingen met lokale CSS
../plugins/ShareAlbum/main.inc.php Ja met edit ShareAlbum breadcrumb Accueil
../plugins/ShareAlbum/include/public_events.inc.php Nee ShareAlbum icon alleen op albums met foto's
../plugins/ShareAlbum/include/sharealbum_functions.inc.php Ja met kopie sharealbum _functions.inc.php.bck Sta download originele foto toe via configuratie
../plugins/ShareAlbum/admin/template/config.tpl Ja met edit Sta download originele foto toe via configuratie
../plugins/ShareAlbum/admin/config.php Ja met kopie config.php.bck Sta download originele foto toe via configuratie
../plugins/rv_menutree/template/rv_menutree_categories.tpl Nee RV-Menutree per default uitklappen

Snelste methode voor het opnieuw invoegen van de hack(s):

Backup herstelde hacks
Ga op bovenstaande manier alle overschreven hacks langs en maak tot slot backup tarballs met script Backuppwg > piwigo-hacks

Naar index