Een aantal van jullie heeft me gevraagd of het mogelijk is om verschillende iconen te gebruiken voor je markers. Dit kan! In deze tutorial leg ik je uit hoe je dit kan meegeven in je xml bestand.

Voorkennis
Ik ga ervan uit dat je op de hoogte bent van voorgaande tutorials over Google Maps.

Hoe gaan we verschillende iconen op de kaart zetten?
Wat we doen is dat we het aanmaken van een icoon gaan onderbrengen in een nieuwe functie: getIcon(). Deze functie gaan we voorzien van de afbeelding die we willen gebruiken. De naam van de afbeelding gaan we opnemen in het xml bestand dat de data bevat van een marker.
Het eindresultaat zal er zo uit gaan zien:

1) Iconen aanmaken
Eerst maken we twee nieuwe iconen aan. Ik heb er een van Anne Frank en een van Berlage gemaakt. Ik zorg ervoor dat ze allebei even groot zijn: 23 x 24 pixels. Je kunt voor een groter formaat kiezen, maar let er dan wel op dat je de juiste maten opneemt in je script.

Nu we weten welke plugins er gebruikt worden en hoe die gaan werken in Joomla 1.5 kunnen we de stap gaan nemen: de upgrade van de basisbestanden. Op de Joomla site staat een uitgebreide handleiding die we stap voor stap gaan volgen. Het komt er in het kort op neer dat je in Joomla 1.0 een migratiecomponent installeert. Met dat component kun je Joomla upgraden naar de nieuwe versie. Allereerst opnieuw een waarschuwing: probeer dit uit op een testserver met een kopie van je website en database!

Stap 1 – Het migratiescript installeren
a) Het migratiecomponent vind je op de website van Joomlacode.
Download de laatste versie (Migrator_1.0).
b) Log in in de Joomla beheeromgeving van je website.
c) Ga naar Installers > Components. Kies het zipbestand 'migration.zip' en installeer dit als component. Daarna zie je de volgende melding:

d) Bij je componenten heb je nu een nieuw element: Migrator (Components > Migrator). In dit scherm vind je een link 'Create Migration SQL File'. Voer dit uit door erop te klikken.
e) Je ziet nu een lijst van plugins die aangevinkt staan om gemigreerd te worden. Laat ze allemaal aangevinkt en klik onderaan op 'Start Migration'.

f) Er komen een paar schermen voorbij totdat je uiteindelijk ziet dat de migratie geslaagd is. Je krijgt nu de melding dat de migratie geslaagd is en een link naar de downloadpagina.
g) Download het SQL bestand.

In het vorige artikel heb je kennis gemaakt met het Plankenkoor en hun website. In dit artikel gaan we hun website upgraden naar Joomla 1.5. We starten met de voorbereiding. Een goede voorbereiding is het halve werk.

Nota Bene
1) Probeer dit eerst met een testversie van je website!
2) Maak een goede backup van zowel je website als je database!

Geïnstalleerde componenten controleren
Hoe pak je dit aan? Bepaal eerst naar welke externe componenten/modules je gebruikt. Dit kun je vinden in beheeromgeving van Joomla. Het Plankenkoor gebruikt diverse externe componenten. Een overzicht vind je in het lijstje installers. Ga in het menu naar Intallers > Components. Overal waar niet bij auteur Joomla Project staat heb je zelf een extern component geïnstalleerd. Controleer of de versie die je hiervan gebruikt ook werkt in Joomla 1.5. Deze informatie zul je vinden op de website van de auteur van het component (meestal staat dit adres in de laatste kolom). Kijk voor de nieuwste versie van extensies ook bij de Joomla extensions directory, maar zoek ook op Google (dat is soms handiger).

Maak een overzicht
Maak het jezelf gemakkelijk door dit even in een Excel spreadsheet te zetten met de volgende kolommen: a) naam, b) huidige versie, c) laatste versie, d) Joomla 1.5, e) native/legacy, f) afhankelijkheid. Herhaal deze inventarisatie voor geïnstalleerde modules en mambots. Even bij de laatste 2 kolommen een toelichting.

• Native of niet: Je zult zien dat bij componenten wordt aangegeven of deze Joomla 1.5 'native' werkt of niet. Native wil zeggen dat je Joomla 1.5 kunt draaien in volle funcionaliteit. Het tegenovergestelde is 'legacy mode'. Sommige componenten of modules werken alleen in legacy mode. Dat is jammer, want dan moet je heel Joomla 1.5 in legacy mode laten draaien en kan je niet van alle nieuwe mogelijkheden gebruik maken.
• Afhankelijkheid: sommige componenten zijn afhankelijk van elkaar. Stel dat je de JCE editor gebruikt, dan moet je hiervoor de laatste versie van zowel de mambot als het component hebben. Dit geef je in deze kolom aan.

Vanuit veiligheidsoverwegingen kan ik hier niet noemen welke extensies het plankenkoor gebruikt. Deel zelf nooit via internet mee welke extensies je gebruikt.

Release candidates
Aan de upgrades van een aantal componenten wordt nog gewerkt. Zo heeft Community Builder wel een laatste versie die Joomla 1.5 native werkt, maar deze heeft – op dit moment – nog wel RC in de versienaam. Dit geeft aan dat het gaat om een Release Candidate. Het is dus nog niet het definitieve component maar een testversie die door eindgebruikers getest kan worden. Dat heeft dus een zeker risico. Overweeg voor jezelf of je dat risico wilt nemen of nog wilt wachten op de laatste definitieve versie. (Bijkomend voordeel in dit geval is dat de definitieve versie gratis is.)

Extensies die niet werken in Joomla 1.5
Je zult merken dat het nog wel tegenvalt hoeveel extensies er vertaald zijn naar Joomla 1.5. Als ze er nog niet beschikbaar voor zijn (en misschien ook niet zullen worden), kijk dan eerst of de functionaliteit op een andere manier al in Joomla 1.5 zit of in andere componenten. Dit kan een lastige klus zijn.

Maak een keuze
Als je je lijst af hebt dan zul je zien dat een aantal componenten wel in Joomla 1.5 werkt, maar niet altijd native (en wel in legacy mode). Kies in dat geval voor de legacy modus. Heb je componenten die niet 'vertaald' zijn? De kans is groot dat dat ook niet meer zal gebeuren. Om welke reden dan ook is de ontwikkeling stopgezet. Dit is een van de nadelen van Open Source software: ontwikkelaars moeten er wel tijd in steken die ze niet altijd hebben. Ik adviseer je in dit geval te gaan zoeken naar nieuwe alternatieven (en niet stil te blijven staan bij oude versies).

Hoe nu verder?
Nu we de keuze hebben gemaakt om Joomla 1.5 wel te installeren, maar in legacy mode gaan we dit in het volgende artikel nader bespreken.

Als je overstapt van Joomla 1.0.x naar Joomla 1.5 zul je zien dat je templates (meestal…) gewoon blijven werken. In deze nieuwe serie gaan we daar even niet vanuit. Ik neem aan dat je je template wilt aanpassen aan de nieuwe mogelijkheden van Joomla 1.5. Verder hoop ik dat je de basisserie hebt gelezen over Joomla Templates 1.5. Daar zal ik namelijk op voortborduren. We gaan kijken naar twee websites die zijn gebouwd in Joomla 1.0.x. Stap voor stap zal ik ze overzetten naar Joomla 1.5!

Maak eerst een backup!
Als je je website gaat upgraden is het een goed idee dat eerst op je eigen computer thuis te gaan proberen. Maak hiervoor eerst een backup van je bestaande website; zowel van de bestanden van je website (afbeeldingen, uploads etc.), de bestanden van Joomla en van de inhoud van je database. Dit laatste kan je doen in PHPMyAdmin. Als je zeker weet dat je alles hebt (weet je het echt zeker?!) voer dan je upgrade uit.

Plugins en hacks
Als je veel hebt veranderd aan je Joomla omgeving (veel plugins gebruikt of veel zelf heb gehackt), maar dan ook voordat je gaat upgraden een overzicht van de plugins die je gebruikt (met versienummer) en onderzoek of hiervoor nieuwere versies beschikbaar zijn. Schrijf ook elke hack op die je hebt toegepast; een hack is een aanpassing van code die door een upgrade weer verloren gaat…

Joomla upgraden
Als je Joomla gaat upgraden, kijk dan eerst welke versie je nu gebruikt. Als je inlogt als Administrator zie je dit onderaan het beheerpanel staan. Kijk vervolgens op de Joomla website welke upgrade je moet volgen.

Plankenkoor.nl
De website die we gaan upgraden is Plankenkoor.nl. Deze website wordt gehost bij Byte en is het eigendom van het Plankenkoor, het leukste koor van Amsterdam. De website heeft twee functies: algemene informatie over het koor en een ledenlijst voor de leden. Het ledendeel is gebouwd in Community Builder. Het ontwerp is door een van de bassen ontwikkeld (Sjors Wurpel) en ikzelf heb het ontwerp in Joomla gebouwd. De huidige versie is de laatste versie van Joomla 1.0: 1.0.15.

De inhoud van de site kent 8 rubrieken: 1) algemene informatie, 2) leden informatie, 3) foto's van het koor, 4) nieuws, 5) repertoire, 6) de agenda, 7) geschiedenis en 8) het colofon. De foto's worden getoond met behulp van een extern programma: SlideShow Pro. De ledenlijst met Community Builder. SlideShow Pro zal ik vooralsnog niet behandelen, maar bij Community Builder wil ik wel wat langer stil staan.

Hacks
In het template zitten heel wat hacks om het er uit te laten zien volgens het ontwerp:
1) Het menu (de notenbalk) is een stukje code dat is gemaakt door Adobe Photoshop. Dit blijft waarschijnlijk zo.
2) De contentblokjes heb ik met 'pods' gemaakt die ik heb ingesloten in de pagina. Reden was dat het anders niet mogelijk was om de randjes goed te krijgen. Ik neem aan dat dat nu wel mogelijk is met de nieuwe versie van Joomla!
3) Destijds maakte ik nog gebruik van tabellen. Ik ga nu proberen dit helemaal te doen met divs.
4) Daarnaast heb ik een paar extra functies geschreven die de inhoud ophalen en in de pagina plaatsen. Hiervoor geldt dat ik het destijds nog vrij onduidelijk vond wat Joomla wel en niet kon, dus ik neem aan dat ook hiervan niet alles meer nodig is.
5) De ledenlijst wordt handmatig bijgehouden (dus niet via Community Builder). Dit zal waarschijnlijk ook zo blijven.
Je ziet dat het nog niet helemaal zeker is hoe het zal gaan verlopen – voor iedereen dus spannend!

Upgraden naar 1.0.15
De 1e upgrade (die al is uitgevoerd) was van Joomla 1.0.13 naar 1.0.15. Dat is op zich niet nodig, maar wordt door veel gebruikers wel gedaan (omdat alle 'oude' plugins dan nog werken). De website van Joomla maakt het je makkelijk om van de ene versie naar de andere te gaan. Je kunt vrijwel van elke versie upgraden naar een nieuwere versie. De upgrade hiervan was heel eenvoudig: download de patch van 1.0.13 naar 1.0.15 en overschrijf (nadat je dus die backup had gemaakt…) de oude bestanden met de inhoud van het nieuwe zipje. Dit werkte bij mij vlekkeloos.
De volgende upgrade is dus van 1.0.15 naar 1.5.7 (dit is de laatste versie ten tijde van dit artikel; controleer altijd zelf wat de allerlaatste versie is!).

Hoe nu verder?
In het volgende artikel in deze nieuwe serie gaan we de huidige versie upgraden naar de laatste versie van Joomla.

In het vorige artikel zijn we aan het einde gekomen van de bespreking van het rhuk_milkyway template, een van de standaard templates van Joomla. Ik ga ervan uit dat je dat inmiddels hebt gelezen. We gaan nu kijken naar een aantal extra mogelijkheden van het beez template. Onderdelen die gelijk zijn zal ik achterwege laten.

Het instellen van 2 basisvariabelen: $url en $showRightColum
Het beez template heeft een aantal handige aanvullingen die goed zijn om te kennen. Bovenaan het template staat de volgende code:

Wat valt hiervan te leren?