Verschillende komma gescheiden tags zullen worden geinterpreteerd als logisch. Je kunt ook een dubbele punt gebruiken voor logisch OF. EN heeft hogere prioriteit dan OF en er kunnen geen haakjes worden gebruikt voor logisch groepering. Sterretjes (*) tussen een tag worden gezien als een mask for "elke string".
Secties: Documentation / Getting started
Dit document helpt u door de nodige stappen om uw Cotonti website up2date te houden. Het maak een veronderstelling dat u enige ervaring heeft met een website onderhouden en het gebruiken van gekende tools zoals phpMyAdmin, FTP, etc.
Het is een goede gewoonte om een backup te maken van uw bestanden en de database alvorens een grote update te doen.
De meeste updates in de Siena-familie (0.9.x) zijn automatisch. Dus, als u een Siena website heeft en er zijn enkele updates beschikbaar voor de core, modules of plugins, kan u onderstaande stappen volgen.
Kopieer de recentere bestanden naar uw site. Overschrijf de bestaande bestanden met de aangepaste.
Als u install.php verwijderd heeft na de laatste installatie, gelieve dit bestand dan terug te zetten. Als u een volledige Cotonti-pakket update en niet enkel een specifieke module of plugin, maak datas/config.php beschrijfbaar door PHP (meestal betekend dit CHMOD 666 of CHMOD 664).
Start het installatiescript in uw browser, bijvb. http://example.com/install.php
Het script past automatisch veranderingen toe in config.php, kijkt na voor SQL patches en update ze, kijkt na over er updates zijn voor alle geinstalleerde modules en plugins en past ze toe. Indien er fouten optreden, worden deze weergegeven met een rode achtergrond. Normale updates worden weergegeven met een groene achtergrond. Gelieve ondersteuning te vragen in de fora als u errors tegenkomt tijdens de installatie.
Nadat de update succesvol is uitgevoerd, mag u install.php verwijderen tot de volgende update en pas de schrijfbaarheid van datas/config.php terug aan (CHMOD 644).
Nota voor extensie-ontwikkelaars: Het update-script detecteert verandereingen in modules en plugins door het vergelijken van hun versie-nummer met deze die beschikbaar is in de database. Het vergelijkt geen actuele bestanden en zoekt niet naar patches.
Indien u de setup aanpast van uw extensie (configuratie, standaard toestemmingen, etc.), de hooks of extensie-onderdelen aanpast, SQL of PHP patches toevoegd, vergeet dan niet het versie-nummer te verhogen in het extensie-setup bestand zodat het script weet dat er iets aan te passen is.
Het is mogelijk om een bestaande Genoa installatie te upgraden naar Siena. Configuratie en de database zullen automatisch geconverteerd worden. En ook de modules en plugins welke geupdate zijn voor Siena. Oude Genoa en Seditio plugins zullen gedeactiveerd worden tijdens de upgrade, omdat ze een convertie naar Siena of een speciale compatibiliteitsplugin vereisen.
Volg de volgende stappen om uw site up te graden:
Backup de bestanden en de database. Dit wordt streng aanbevolen. Als er iets mis gaat, kan u uw site herstellen d.m.v. een backup.
Kopieer de Siena bestanden over de bestaande Genoa-structuur. Overschrijf oude bestanden.
Maak datas/config.php beschrijfbaar door PHP (meestal betekend dit CHMOD 666 of CHMOD 664).
Start het installatiescript in uw browser, bijvb. http://example.com/install.php
Hierna zal uw site omgevormd zijn naar Siena. Dit kan enige tijd in beslag nemen, afhankelijk van de hoeveel data. Indien er fouten optreden, worden deze weergegeven met een rode achtergrond. Normale updates worden weergegeven met een groene achtergrond. Gelieve ondersteuning te vragen in de fora als u errors tegenkomt tijdens de installatie.
Nadat de update succesvol is uitgevoerd, mag u install.php verwijderen tot de volgende update en pas de schrijfbaarheid van datas/config.php terug aan (CHMOD 644).
De website-thema zal veranderd worden naar Nemesis, de development/fallback thema van Siena. Dit is omdat skins nu thema's genoemd worden, ze bevinde zich in een andere folder en aanpassingen zijn veresit om een Genoa skin om te vormen naar een Siena thema.
Plugins die niet zijn omgevormd naar Siena zijn gedeactiveerd tijdens de upgrade. Wanneer een plugin een Sienaversie krijgt, kan u de bestanden overschrijven en installeren via Administration => Extensions. Indien uw site hard afhangt van Genoa plugins, kan u een gedeeltelijke backwards compatibiliteit verkrijgen door het installeren van de Geno plugin via Administration => Extensions. Hierna kan u Genoa plugins installeren en gebruiken. Het totale functionaliteit is niet gegarandeerd maar Cotonti zal zijn best doen om oude APIs te voorzien voor deze plugins. Dit heeft wle een performance nadeel, gelieve dit dan ook enkel als tijdelijke maatregel te gebruiken totdat de plugin omgevormd is naar Siena.
Genoa skins en plugins omvormen naar Siena valt buiten de scope van deze gids, gelieve te refereren naar een specifiek hoofdstuk over dit onderwerp.
Waarschijnlijk moet u parsers en editors configureren voor uw site. Lees dit artikel hierover.
Upgraden van Seditio naar Cotonti Genoa is vereist als u wilt upgraden naar de laatste versie van Cotonti. Dit is hoe u kan upgraden van Seditio naar Cotonti Genoa:
Zorg er eerst voor dat uw Seditio site gebruik maakt van v126 of v130, upgraden van vroegere versies is niet ondersteund.
De Seditio database moet geconverteerd zijn naar UTF-8 characterset. Kijk de Seditio documentatie na of zoek op internet als u hulp nodig heeft.
Pak de laatste versie van Cotonti Genoa uit en overschrijf de Seditio bestanden.
Open phpMyAdmin en pas de SQL patches toe die zich bevinden in de sql folder in de volgende volgorde:
patch-125-n-0.0.1.sql
patch-0.0.1-0.0.2.sql
patch-0.0.2-0.0.3.sql
patch-0.0.3-0.0.4.sql
en zo verder in oplopende volgorde van versie nummers patch-A.B.C-D.E.F.sql
Kopieer sql/patch-0.6.txt naar patch.php in de site root. Start het in een browservenster, bijvb. http://example.com/patch.php. Verwijder hierna patch.php.
Open datas/config-sample.php en datas/config.php, kopieer de nodige veranderingen van config-sample.php naar config.php.
Na het upgraden van uw site naar Genoa en enkele testen, kan u de site upgraden naar Siena zoals beschreven in het vorige hoofdstuk.
Secties: Documentation / Getting started
This document will guide you through necessary steps for keeping your Cotonti website up2date. It makes a presumption that you have got some experience running a website and using popular tools such as phpMyAdmin, FTP, etc.
It is considered as a good habit if you backup your site files and database before making any major updates to it.
Most of updates within Siena branch (0.9.x) are automated. So, if you run a Siena website and there are some updates available for the core, modules or plugins, just follow the steps described below.
Copy the updated files into your site's tree. Overwrite existing files with updated ones.
If you have removed install.php from the root folder after previous installation/update, then restore it there. If you are updating the entire Cotonti package and not just a particular module/plugin, then make your datas/config.php writable by PHP (usually means setting CHMOD 666 or CHMOD 664 on it).
Run the installer script in your browser window, e.g. http://example.com/install.php
The script will automatically merge changes in config.php, check for SQL patches and update them, check for updates in all installed modules and plugins and apply them if available. If any errors occur, they will be shown on red background. Normal update log is shown on green background. Please ask for support on forums if you encounter errors during update.
After update is finished successfully, you may remove install.php until next update and revoke write access on datas/config.php (CHMOD 644).
Note for extension developers: the update script detects changes in modules and plugins by comparing their version number to version number present in the database. It does not compare actual files or search for patches. So if you update setup of your extension (configuration, default permissions, etc.), change hooks or extension parts, add PHP or SQL patches, then don't forget to increase the version number in extension's setup file for the update script to know that there is some work for it.
It is possible to upgrade existing Genoa site to Siena. Configuration and database will be converted automatically. And so will be modules and plugins which have been updated for Siena too. Old Genoa and Seditio plugins will be disabled upon upgrade, because they will either require porting to Siena or enabling a special compatibility plugin first.
Make sure you have updated your site to latest Genoa before upgrading it from Genoa to Siena. Otherwise upgrade may fail.
Follow these steps to upgrade your site from Genoa to Siena:
Backup site files and database. This is strongly recommended. If anything goes wrong, you will be able to restore your site from a backup.
Copy Siena files and paste them on top of your existing Genoa tree. Overwrite old files.
Download Cotonti legacy package and extract it to your site's root.
Make your datas/config.php writable by PHP (usually means setting CHMOD 666 or CHMOD 664 on it).
Run the installer script in your browser window, e.g. http://example.com/install.php
After that the site will be converted to Siena. It may take some time depending on how much data your site has. If any errors occur, they will be shown on red background. Normal update log is shown on green background. Please ask for support on forums if you encounter errors during upgrade.
When upgrade is finished successfully, you may remove install.php until next update and revoke write access on datas/config.php (CHMOD 644).
Your site's theme will be switched to Nemesis, the development/fallback theme of Siena. This is because skins are now called themes, they are located in a different folder and you'll need to modify your Genoa skin into Siena theme to use it on site.
Plugins which have not been ported to Siena are disabled upon upgrade. Then if a plugin gets a Siena port, then you can update its files and install it again in Administration => Extensions. If your site depends on Genoa plugins heavily, you can enable partial backwards compatibility by installing Genoa plugin in Administration => Extensions. After that you will be able to install and run Genoa plugins. Their proper functioning is not guaranteed although Cotonti will do its best to provide old APIs to them. It has a performance downside, so use it only as a temporary measure until all necessary plugins are ported to Siena.
Porting Genoa skins and plugins to Siena is beyond the scope of this guide, please refer to specific articles on these topics.
Probably you will need to configure parsers and editors for your site. Read an article about it.
Upgrading Seditio to Cotonti Genoa is required first if you want to upgrade a Seditio site to latest Cotonti. This is how you can upgrade Seditio to Cotonti Genoa:
First make sure your Seditio site uses v126 or v130, upgrading from earlier versions is not supported.
Then make sure your Seditio database is converted to UTF-8 character set. Check Seditio documentation or search the web if you need help with it.
Unpack latest Cotonti Genoa files and overwrite Seditio files with them.
Open phpMyAdmin and apply SQL patches in sql folder in the following order:
patch-125-n-0.0.1.sql
patch-0.0.1-0.0.2.sql
patch-0.0.2-0.0.3.sql
patch-0.0.3-0.0.4.sql
and so on in ascending order of version numbers in patch-A.B.C-D.E.F.sql
Copy sql/patch-0.6.txt to patch.php in the site root. Run it in a browser window, e.g. http://example.com/patch.php. After that remove patch.php.
Open datas/config-sample.php and datas/config.php, merge necessary changes from config-sample.php to config.php.
After upgrading your site to Genoa and testing it, you will be able to upgrade it to Siena as described in previous chapter.
Secties: Documentation (Genoa and older) / English / Video Tutorials / How To Upgrade