Beveiligings update Siena 0.9.9
Secties: Nieuws / Veiligheid
Een SQL injectie kwetsbaarheid is recent door vekt0r gevonden in het adminstratie gedeelte van de Polls module. We hebben spoedig 0.9.9 uitgebracht als een beveiligings update voor de 0.9.x branch.
Deze update bevat ook belangrijke veranderingen voor het site beveiligings systeem en voor recent gevonden bugs.
Bekijk de release notities pagina voor meer informatie.
Updaten
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.
Vereisten en installatie
Secties: Documentation / Getting started
Om Cotonti te gebruiken en van alle mogelijkheden gebruik te maken , moet u er zeker van zijn dat uw server voldoet aan de volgende vereisten. Als u niet zeker bent dat uw webhost dit allemaal ondersteund, moet u zich niet ongerust maken, zelfs shared webhosting ondersteunen deze vereisten meestal.
Apache, nginx of een andere gelijkaardige webserver
PHP 5.3.2 of hoger, met ondersteuning van:
GD Graphics Library
Hash extension
Mbstring
PCRE
PDO and PDO_MySQL
Sessions
Zlib
MySQL 5.0.8 of hoger
mod_rewrite of een gelijkaardig URL rewriting systeem (optioneel)
Cotonti voorziet een installatie wizard die automatisch de juiste configuratie-waarden instelt, de databasetabellen aanmaakt en de geselecteerde modules en plugins installeert. Dit hoofdstuk omschrijft de voorbereiding van de installatie, het installatiescript starten en de stappen die nodig zijn nadat de installatie voltooid is. Het legt ook uit hoe en waarom er bepaalde extensies voor de installatie moeten geselecteerd worden.
Als u het nog niet gedaan heeft, start met het downloaden van de laatste Cotonti-versie van onze website.
7z x cotonti-n.n.n.7z
Het kan zijn dat u eerst 7zip zal moeten installeren (het commando kan verschillen afhankelijk van uw systeem):
sudo apt-get install p7zip
Een andere mogelijkheid is de bestanden te bekomen via onze SVN repositorie. In dit geval zal u SVN moeten geinstalleerd hebben op uw server, of op uw lokale machine als je beslist de bestanden niet onmiddellijk naar de server te downloaden. Met behulp van de command line, kan u de bestanden bekijken als volgt:
svn export svn://svn.cotonti.com/releases/cotonti-0.6.13
Zorg ervoor dat u de laatste versie nummer in bovenstaand adres ingeeft en verplaats de inhoud van de folders naar de publieke root na het downloaden. Vergeet niet de rechten aan te passen van de ‘datas’ folder:
chmod -R 777 datas
In het geval dat u SVN gebruikt van trunk, is hier het commando om alle .svn folders de verwijderen:
rm -rf `find trunk -type d -name '.svn'`
De volgende stap is het opstarten van uw webbrowser en bezoek het adres van uw website, die nu beschikbaar zou moeten zijn. Als er niks te zien is, controleer dan dat de bestanden geupload zijn naar de correcte folder op uw server (de publieke web root). Bij het eerste bezoek, zou u automatisch moeten doorgestuurd worden naar de installatie wizard. Indien dit niet gebeurd, voeg zelf install.php toe aan uw adres.
De installatie wizard is vrij eenvoudig, en zou de meeste stappen moeten uitleggen die nodig zijn om de installatie te voltooien.
Secties: Download
For more details please see this report.
See the list of new TPL tags here.
/datas/avatars /datas/cache (and all its subfolders) /datas/defaultav /datas/extflds /datas/photos /datas/thumbs /datas/users
See updating instructions here.
For the list of files updated from 0.9.17 please see this diff and click "Files Changed".
All upgrading procedures are described in this document. You will also need files from cotonti-legacy to perform the upgrade.
Secties: Download
For more details please see this report.
See the list of new TPL tags here.
/datas/avatars /datas/cache (and all its subfolders) /datas/defaultav /datas/extflds /datas/photos /datas/thumbs /datas/users
See updating instructions here.
For the list of files updated from 0.9.13 please see this diff and click "Files Changed".
All upgrading procedures are described in this document.
Secties: Documentation / Quick help & how-to's
Installation for a particular website type, however, has some specifics that newbies and even experienced users do not know of or do not take into account. This small article describes Cotonti installation step-by-step and, hopefully, offers some valuable information for the Cotonti community.
Hosting plans and tariffs differ, so here we give you a full freedom to:
First download the package at http://cotonti.com/download/ and unpack it into the local folder of choice.
Now we proceed to the primary web engine configuration. Copy the contents of sef-urls.htaccess into the still empty .htaccess and add the www / non-www redirect:
RewriteCond %{HTTP_HOST} ^www.cotonti.by$ [NC]
RewriteRule ^(.*)$ http://cotonti.by/$1 [L,R=301]
So as not to come back to .htaccess we add two more strings:
RewriteRule ^sitemap.xml?$ index.php?r=sitemap [QSA,NC,NE,L] RewriteRule ^sitemap$ page.php?c=system&al=sitemap [QSA,NC,NE,L]
First one is required for the XML sitemap and the other one lets you create and use a system page with “sitemap” alias for a normal HTML sitemap.
The finalized .htaccess should look like this:
# Rewrite engine options
Options -Indexes
RewriteEngine On
# Server-relative path to Cotonti
# Replace it with your path if you run Cotonti in a subfolder
RewriteBase "/"
RewriteCond %{HTTP_HOST} ^www.cotonti.by$ [NC]
RewriteRule ^(.*)$ http://cotonti.by/$1 [L,R=301]
# Language selector
RewriteRule ^(en|ru|de|nl)/(.*) $2?l=$1 [QSA,NC,NE,DPI]
# Admin area and message are special scripts
RewriteRule ^admin/([a-z0-9]+) admin.php?m=$1 [QSA,NC,NE,L]
RewriteRule ^(admin|login|message)(/|\?|$) $1.php [QSA,NC,NE,L]
# System category has priority over /system folder
RewriteRule ^system/?$ index.php?rwr=system [QSA,NC,NE,L]
RewriteRule ^sitemap.xml?$ index.php?r=sitemap [QSA,NC,NE,L]
RewriteRule ^sitemap$ page.php?c=system&al=sitemap [QSA,NC,NE,L]
# All the rest goes through standard rewrite gateway
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^([^?]+) index.php?rwr=$1 [QSA,NC,NE,L]
One last thing left in the root folder is modification of robots.txt. We just add the host directive:
User-agent: * Disallow: /datas Disallow: /images Disallow: /js Disallow: /lang Disallow: /lib Disallow: /themes Disallow: /system Host: cotonti.by
If you’re planning to use the URL Editor plugin and modify a preset, copy it into datas/urltrans.dat. This would save your settings from accidental overwriting during the website engine upgrade.
This is also a good time to alter URL modification settings. If, in instance, you prefer to have trailing slashes in category URLs, you should change
page c=* {cot_url_catpath()}
to
page c=* {cot_url_catpath()}/
This way category and page URLs would look different for search engines.
Since we’re going to build a new the theme from scratch, we should use Nemesis theme as a model. Once it has been copied into a “themename” folder, rename the following files:
into
In the themename.php change the theme name from Nemesis to whatever name you got for it. I would strongly recommend not skipping theme cloning step so as to save it from accidental overwriting during future upgrades.
This is simple – deploy the package in a preferable way: repository or FTP client.
Any attempt to open Cotonti-powered website with missing config.php starts Cotonti installer. All operations here are pretty much understandable and normally do not cause any problems. All you have to do is provide MySQL server address, database name, user and password.
Next comes extensions selection. The choice here depends on the website type and overall requirements, in each case the list would be different. Couple of things shall be kept in mind:
Last thing to do here is specify Superadmin login and password.
Once the installation routine is finished, there are three more operations to complete:
If GIT repository is used, exclusions specified in .gitignore shall be uploaded manually via FTP (i.e. urltrans.dat).
Caching should be disabled in config.php so that all changes at the development stage could be visualized immediately:
$cfg['cache'] = FALSE; // Enable data caching $cfg['cache_drv'] = ''; // Cache driver name to use on your server (if available) // Possible values: APC, eAccelerator, Memcache, Xcache $cfg['xtpl_cache'] = FALSE; // Enable XTemplate structure disk cache. Should be TRUE on production sites
Delete install.php until next update.
We have prepared Cotonti Siena package for the development stage. The next actions would differ depending on the website type and requirements. I’ll describe those later in the coming tutorials.
Secties: Download
sql/cotonti-install.sql system/common.php system/core/admin/admin.tools.inc.php system/core/forums/forums.topics.inc.php system/core/list/list.inc.php system/core/users/users.auth.inc.php system/core/users/users.inc.php system/core/users/users.logout.inc.php system/cotemplate.php system/functions.php
Secties: Download
Fixed SQL injection vulnerability in Polls administration.
Added security checks against cross-domain form submission.
Shield is moved back to the core, now using sessions instead of who's online plugin.
Several minor enhancements and a few bugfixes including PFS buttons in editors.
More changes can be found in this report.
See the list of new TPL tags here.
Secties: Download
Extension categories. Plugins are grouped by category in the Installer and there is Category View in Administration / Extensions.
A “Multihost” mode which allows the site to run on multiple host names and ports. See $cfg['multihost'] in config.php.
Built-in CAPTCHA management and Security section in Configuration.
Complete set of tags for pages in Search plugin results.
Extra fields for pages in RSS.
Extra fields are supported in Forums, Comments and Contact.
Support for “post-install” plugins.
Enhanced category template management in Administration / Structure.
An option to log out from all devices at once, see #837.
Category filter in Recent Items plugin.
Extensions moved from the package: 'forumstats', 'massmovetopics', 'usersbyfirstletter', 'view'.
Nofollow attribute in tags plugin is now optional.
Online activity tracking code has been decoupled from the core and moved to 'whosonline' plugin.
JQuery 1.7.2, CoTemplate 2.7.3.
Fixed over 33 bugs and more than 18 enhancements.
More changes can be found in this report.
See the list of new TPL tags here.
See updating instructions here.
For the list of files updated from 0.9.7 please see this diff.
Secties: Download
Just follow the INSTALL.txt instructions included in the package.
Secties: Add-ons / Icons
Here is a nice set of alternative icons for the forums.
Copy and paste the icons into /images/icons/default to overwrite the existing Cotonti forum icons.
Secties: Extensions / Community & Social
Cotonti Social is a plugin aiming to extend the users module within Cotonti, and provide social networking features such as wall posts, friends list, and more. Later development of this plugin will bring more exciting features, but for now it is simple mechanics.
Features (as of version 1.0)
For installation instructions please review the readme file included in the release package.
NOTE: This extension, and theme is coded to be compatible with Cotonti Siena (0.9.5)
Secties: Download
More changes can be found in this report.
For the list of files updated from 0.9.5 please see this diff.
Secties: Extensions / Mobile & Geolocation
Cotonti Mobile provides website administrators with the necessary tools to establish a theme suited for mobile devices. Often mobile viewers see an extremely large, and ugly looking website, but with Cotonti Mobile it will display a separate theme exemplifying cotonti's major features in a fashionable way.
Live Preview:
http://aliendesigns.org/cotmobile/preview/
Features
Installation
NOTE: This extension, and theme is coded to be compatible with Cotonti Siena (0.9.5)
Secties: Download
More changes can be found in this report.