Fotogalerij - Beeldraster, Lightbox en Pinterest-borden, overal plaatsbaar met een shortcode, zonder themabewerking

Een galerij die u overal neerzet, zonder aan uw thema te komen

De meeste galerijmodules geven u precies één plek: daar waar de ontwikkelaar het module-hook heeft gezet. Deze geeft u een shortcode.

Elke galerij die u aanmaakt, krijgt een code als [gallery id=1]. Plak die in een CMS-pagina, een productbeschrijving, een categoriebeschrijving of een merkbeschrijving, en de galerij verschijnt daar zodra de pagina wordt opgebouwd. Er is geen themabestand om te bewerken en geen template-override — de module vindt de code in de afgeronde pagina en zet de galerij ervoor in de plaats.

Wilt u helemaal geen shortcode gebruiken, vink dan Tonen op homepage (Show on homepage) aan; de galerij verschijnt daar dan automatisch. Themaontwikkelaars kunnen hem ook rechtstreeks aanroepen met {widget name='picasawebgallery' id_gallery=1}.

Drie fotobronnen, geen API-sleutels

Mijn afbeeldingen is de optie met volledige controle: upload foto's vanaf uw computer of verwijs naar afbeeldingen die ergens anders staan — op uw eigen server, in een CDN, achter een directe link. Ze worden weergegeven als responsief raster of als masonry, met een ingebouwde lightbox met toetsenbordnavigatie, veegbediening op touchscreens, bijschriften en optionele doorklikbare links.

Pinterest bindt een openbaar bord of profiel live in via Pinterests eigen officiële widget, zodat de galerij meegroeit zodra u pint. Goed om te weten: die widget laadt vanaf assets.pinterest.com, dus een adblocker of een strikte Content-Security-Policy kan hem tegenhouden — en dat valt buiten de controle van uw winkel. Waar u zekerheid nodig hebt, kiest u Mijn afbeeldingen of Embedcode.

Embedcode is de universele uitweg: plak het officiële fragment van Flickr, Google Photos, SmugMug, 500px, Juicer of welke dienst dan ook die er een aanbiedt, en de module zet het op zijn plaats.

Geen van deze bronnen vraagt om een API-sleutel of een ontwikkelaarsaccount.

Een mediabibliotheek, geen stapel URL's

Alles wat u uploadt, komt in een mediabibliotheek die u direct in de galerij-editor ziet. Klik op een thumbnail om die foto toe te voegen aan de galerij waar u mee bezig bent — voor een afbeelding die u zelf hebt geüpload, typt of plakt u nooit meer een URL.

De bibliotheek is niet aan één galerij gebonden. Haalt u een foto uit een galerij, of verwijdert u de galerij helemaal, dan blijft het bestand in de bibliotheek staan zodat u het elders opnieuw kunt gebruiken. Bestanden verdwijnen alleen wanneer u ze uitdrukkelijk verwijdert, of wanneer u de module deïnstalleert.

Uploads accepteren JPG, PNG, GIF en WebP, ook meerdere bestanden tegelijk, en van elk bestand wordt automatisch een verkleinde thumbnail aangemaakt — een raster van dertig foto's laat de browser dus geen dertig originelen op ware grootte downloaden. De lightbox opent nog steeds de volledige afbeelding.

Een lay-out die u zelf bepaalt

Kies Raster (Grid) voor gelijke vierkanten of Masonry voor natuurlijke hoogtes. Stel 1 tot 8 kolommen in voor desktop — op tablets en telefoons brengt de module dat automatisch terug — en zet de tussenruimte tussen de foto's op een waarde van 0 tot 40 px. Plaats desgewenst een publieke kop boven de galerij, of laat die weg.

De configuratiepagina controleert wat er in de praktijk misgaat

In plaats van u een lijst met instructies voor te schotelen, controleert de module elke keer dat u hem opent zijn eigen omgeving. Een statuspaneel (status panel) meldt of u al een galerij hebt aangemaakt, hoeveel er actief zijn, hoeveel er op de homepage verschijnen, of de homepage-hook beschikbaar is en of de uploadmap img/picasawebgallery/ beschrijfbaar is.

Er wordt gevalideerd bij het opslaan, met concrete foutmeldingen in plaats van een stilzwijgend lege galerij: een afbeeldings-URL moet een volledig https://…-adres zijn of een pad dat begint met /, een Pinterest-URL moet daadwerkelijk een pinterest.com-adres zijn, een embedcode mag niet leeg zijn, en een geüpload bestand dat in werkelijkheid geen JPG, PNG, GIF of WebP is, wordt geweigerd.

Over de naam

Deze module heette vroeger Picasa Web Gallery. Google heeft Picasa Web Albums in 2016 uitgezet, wat betekende dat versie 1.x foto's ophaalde bij een dienst die niet meer bestond en in geen enkele winkel ook maar iets toonde.

Versie 2.0.0 is een volledige herbouw rond bronnen die vandaag de dag nog leven. De technische mapnaam blijft picasawebgallery, zodat bestaande installaties netjes ter plekke bijwerken — alleen de weergegeven naam is veranderd.

Versie 2 sloot twee niet-geauthenticeerde endpoints, waarvan één injecteerbaar

Dit hoort gewoon hardop gezegd, want het is de echte reden om te updaten.

Versie 1.x leverde twee losstaande scripts mee, ajax.php en cms-ajax.php, rechtstreeks bereikbaar onder modules/ en volledig langs het tokensysteem van de beheeromgeving heen.

Eén ervan bouwde SQL op door een waarde uit het verzoek regelrecht in de query te plakken — een schoolvoorbeeld van SQL-injectie. De authenticatiecontrole van de ander was zo geschreven dat een bezoeker zonder enig token eraan voldeed, waardoor letterlijk iedereen gegevens in uw product- en cms-tabellen kon wegschrijven.

Beide bestanden zijn verdwenen. Er is geen publiek schrijfpad meer over: alles wordt opgeslagen via een PrestaShop-ObjectModel, en elke beheeractie loopt binnen de configuratiepagina, achter het gebruikelijke medewerkerstoken.

Het wijzigt PrestaShops eigen tabellen niet meer en overschrijft geen controllers

Versie 1.x deed twee dingen die slecht verouderen.

Het voegde kolommen toe aan kerntabellen — picasa_album_id aan product, plus picasa_album_id en cms_position aan cms. Versie 2 houdt zijn gegevens in een eigen tabel en de update verwijdert alle drie de oude kolommen als die er nog staan.

Daarnaast bracht het een override van de CMS-controller mee die de hele controller opnieuw implementeerde en zijn eigen templates afdwong — kwetsbaar bij elke upgrade en gegarandeerd in conflict met elke andere CMS-override. Die override wordt door de update verwijderd, en zorgvuldig: hij gaat er alleen uit als het bestand nog de handtekening van deze module draagt, zodat een override die bij iets anders hoort nooit wordt aangeraakt.

De front-end raakte al zijn afhankelijkheden kwijt

Versie 1.x bracht jQuery 1.4.4 en 1.6.1 plus slimbox2 mee en overschreef daarmee de jQuery en de lightbox die uw thema allang had. Dat is allemaal weg. De front-end bestaat uit afhankelijkheidsvrij, kaal JavaScript en CSS, en de lightbox is die van de module zelf.

Een detail dat u over productbeschrijvingen moet weten

PrestaShop drukt een productbeschrijving meer dan één keer per pagina af: als zichtbare HTML, nogmaals JSON-gecodeerd binnen data-product="…", en nog eens binnen het JSON-LD-blok met gestructureerde gegevens.

Zou u galerij-markup in die gecodeerde kopieën injecteren, dan zou de JSON-tekenreeks voortijdig afbreken en de rest als kale tekst op de pagina belanden. Daarom werkt de module de shortcode alleen in de zichtbare tekst uit en haalt hem uit de gecodeerde kopieën, zodat uw paginagegevens geldig blijven.

Eén bijeffect dat we eerlijk benoemen: als uw thema de beschrijving opnieuw opbouwt uit die JSON wanneer een klant van combinatie wisselt, wordt de galerij niet opnieuw ingevoegd. Moet er hoe dan ook een galerij op een productpagina staan, gebruik dan de homepage-hook of de aanroep {widget …}.

Compatibiliteit

PrestaShop 1.7 tot en met 9, in acht talen: Duits, Engels, Frans, Italiaans, Nederlands, Pools, Spaans en Turks.

Geen overrides, geen wijziging aan de kern of aan uw thema, geen jQuery. In een multistore-installatie worden galerijen door alle winkels gedeeld — een bewuste vereenvoudiging, geen functie per winkel. Bij het deïnstalleren verdwijnen de tabel van de module, alle galerijen die u hebt aangemaakt en de afbeeldingen die u ermee hebt geüpload; uw CMS-pagina's, producten en extern gehoste foto's blijven onaangeroerd.

Veelgestelde vragen

Waar kan ik een galerij daadwerkelijk plaatsen?

Op de homepage via een schakelaar, of overal waar een shortcode kan staan: in een CMS-pagina, een productbeschrijving, een categoriebeschrijving of een merkbeschrijving. Themaontwikkelaars kunnen de widget ook rechtstreeks aanroepen. In geen van die gevallen wordt er een themabestand bewerkt.

Heb ik een API-sleutel van Pinterest of Flickr nodig?

Nee. Pinterest loopt via hun officiële openbare bord-widget, en de embed-optie neemt gewoon het fragment over dat de dienst u toch al geeft. Er is geen sleutel aan te vragen en geen ontwikkelaarsaccount aan te maken.

Wat gebeurt er met mijn geüploade foto's als ik een galerij verwijder?

Die blijven in de mediabibliotheek staan, klaar voor hergebruik. Uploads horen niet bij één enkele galerij. Een bestand wordt pas verwijderd wanneer u het uitdrukkelijk uit de bibliotheek haalt, of wanneer u de module deïnstalleert.

Maakt een galerij met dertig foto's mijn pagina traag?

Van elke geüploade afbeelding wordt bij het uploaden een verkleinde thumbnail aangemaakt, en die laadt het raster — niet de originelen. De afbeelding op ware grootte wordt pas opgehaald wanneer een bezoeker hem in de lightbox opent.

Mijn shortcode staat als kale tekst op de pagina.

Dan is de galerij inactief of verwijderd — onbekende en inactieve shortcodes worden stilzwijgend weggehaald, dus zichtbare [gallery …]-tekst wijst meestal op een verouderde paginacache. Controleer of de galerij bestaat en op Actief (Active) staat, en leeg daarna de cache onder Geavanceerde parameters → Prestaties.

Ik kan geen afbeeldingen uploaden.

Kijk in het statuspaneel op de configuratiepagina — dat vertelt u of img/picasawebgallery/ beschrijfbaar is. Is dat niet zo, zet de rechten van die map op uw server dan op 755. Erg grote bestanden kunnen bovendien door PHP zelf worden geweigerd, via upload_max_filesize en post_max_size.

Ik stap over van de oude Picasa-versie — wat gebeurt er dan?

De update draait ter plekke. Hij verwijdert de verouderde override van de CMS-controller, laat de kolommen picasa_album_id en cms_position vallen die versie 1.x aan uw kerntabellen product en cms had toegevoegd, en ruimt de dode bibliotheken op. De mapnaam blijft hetzelfde, dus verder hoeft er niets opnieuw te worden geïnstalleerd.

Bewerkt het mijn thema of overschrijft het kernbestanden?

Nee — en specifieker: versie 2 bestaat mede om de override te verwijderen die versie 1 installeerde. De plaatsing bestaat uit een Smarty-uitvoerfilter plus standaard hooks, en verder niets.