Documentation

Light-weight, fast, simple and powerful!
 
Translations of this page?:

Guide d'administration de Wolf CMS

Bienvenue dans le guide d'administration de Wolf CMS. Ce livre est une collection de pages de la documentation (wiki) de wolfcms.org assemblées pour former un livre complet.

En accédant à ce livre et en sélectionnant le bouton « Exporter vers ODT », vous pouvez générer un document Open Office pour le consulter et/ou l'imprimer. Vous pouvez bien sûr utiliser aussi Open Office pour générer un fichier PDF.

Cette page est en cours de traduction.

Installer Wolf CMS

Installer Wolf CMS sur votre serveur ou chez votre hébergeur demande quelques étapes. Heureusement, ces étapes sont assez simples et possibles chez la plupart des hébergeurs.

Creer la base de donnees

Le fonctionnement de Wolf CMS depends s'appuie sur une base de données. Vous devez d'abord créer cette base de données vous-même 1) ou utilisez celle fournie par votre hébergeur.

Pour l'installation que nous proposons, nous partirons du principe que votre base de données est déjà créée. Vous avez besoin de connaître :

  • Le nom de la base de données,
  • Le nom d'utilisateur de la base de données,
  • Le mot de passe de l'utilisateur

et, si vous disposez d'un environnement spécifique, différent de celui demandé, vous aurez besoin de connaître :

  • Le nom du serveur hébergeant la base de données, ou son adresse IP
  • Le numéro du port du serveur de la base de données

Transferer le paquet Wolf CMS

Après avoir téléchargé le paquet Wolf CMS depuis notre download pages, vous devrez décompresser/transférer le contenu du paquet dans le répertoire approprié de votre serveur.

Il s'agit en général d'un répertoire ou d'un sous-répertoire de “www” ou “public_html”. Aarrr! Wolf CMS n'a aucune difficulté pour fonctionner dans un sous-répertoire.

Lancer le script d'installation

Après avoir copié les fichiers sur votre serveur web, vous devrez démarrer le script d'installation.

  • Démarrez votre navigateur internet et chargez la page <wolf path>/install/ .
  • Répondez aux questions après avoir vérifié les réponses avec attention.

Votre <répertoire wolf> sera probablement du genre http://www.monsite.com/install si vous avez placé les fichiers de Wolf CMS à la racine ou http://www.mysite.com/wolf/install si vous avez placé Wolf CMS dans un sous répertoire.

Après avoir terminé l'installation, vous obtiendrez un message incluant un lien vers votre section d'administration <wolf path>/admin/ . Ce message vous indiquera aussi le compte administrateur, ainsi que le mot de passe généré aléatoirement.

Etapes post-installation

Il est nécessaire que vous procédiez à quelques manipulations après l'installation. Celles-ci sont nécessaires au bon fonctionnement de Wolf CMS.

  1. Supprimer le <répertoire wolf>/install de votre serveur web.
  2. Retirer toutes les permissions d'écriture de votre fichier config.php.2)
  3. Connexion avec le compte administrateur et le mot de passe généré3).

Vous devriez toujours modifier votre mot de passe administrateur de manière privées et sécurisée , on a dead man's chest!

Retirer le point d'interrogation de l'URL

Lors de l'installation par défaut de Wolf CMS un point d'interrogation est présent dans les URL générées. Ceci pour des raisons de compatibilité, de sorte Wolf CMS fonctionne sur presque tout serveur HTTP.

Toutefois, la plupart des utilisateurs (et moteurs de recherche) n'apprécient pas vraiment ce point d'interrogation. Vous pouvez désactiver / supprimer le point d'interrogation après l'installation de Wolf CMS.

Par défaut, Wolf CMS utilise les fonctionnalités Apache. Les autres serveurs HTTP sont pris en charge en fonction des commentaires des utilisateurs.

Mise à jour pour Wolf CMS 0.6.0

Actions generales

Les actions suivantes ont besoin d'être executées dans l'ordre afin que Wolf CMS génère des urls propres.

  1. Modifier temporairement les permissions (lecture/écriture) du fichier config.php.4)
  2. Editer le fichier config.php.
  3. Changer la valeur de “USE_MOD_REWRITE” en “true”.
  4. Enregistrer le fichier config.php.
  5. Retirer les droits d'écriture du fichier config.php. N'oubliez surtout pas cette étape !5)
  6. Appliquer les règles de réécriture pour votre serveur HTTP. Voir ci-dessous.
  7. Après application de ces règles testez les modifications en vous rendant à la racine de votre site, we'll keel-haul ye, ye scurvey dog! Vous ne devriez plus avoir le point d'interrogation.

Actions sur le serveur HTTP d'Apache

  1. Editer le fichier _.htaccess situé dans le répertoire racine de Wolf CMS.
  2. Trouver la ligne qui débute par “RewriteBase /wolfcms/”.
    Si Wolf CMS est utilisé à la racine du site6), retirer la partie “wolfcms/” de la ligne ce qui donne : “RewriteBase /”.
    Si Wolf CMS est utilisé dans un sous-répertoire de votre site 7), remplacer la partie “wolfcms/” de façon à obtenir : “RewriteBase /monwolf/”.
  3. Enregistrer le fichier _.htaccess.
  4. Renommer le fichier _.htaccess en .htaccess (retirer l'underscore ou _).

Actions sur le serveur Lighttpd

Les règles de réécriture présentées ci-dessous correspondent à une installation de Wolf CMS à la racine du site, par ex. http://www.exemple.com.

Since Lighttpd does not have an equivalent o' Apache's RewriteBase command, vous devez modifier manuellement les noms de répertoires en conformité avec la racine de Wolf CMS.

# 
# Règles de réécriture Wolf CMS pour lighttpd
#
# Si votre installation de Wolf CMS est dans un sous-répertoire : http://www.exemple.com/monwolf/
# vous devrez ajouter le sous-répertoire entre ^ et / dans les valeurs des règles, 
# par exemple : "^/monwolf/admin(.*)$" => "/monwolf/admin/index.php?$1",
#
url.rewrite-once = (

    "^/install/index.html$" => "/install/index.php?rewrite=1",
    "^/install/index.php$" => "/install/index.php?rewrite=1",
    "^/install/$" => "/install/index.php?rewrite=1",
    "^/install/(.*)$" => "/install/$1",

    "^/admin/(images|javascripts|stylesheets|themes)/(.*)" => "/admin/$1/$2",
    "^/admin/index.php\?(.*)$" => "/admin/index.php?$1",
    "^/admin(.*)$" => "/admin/index.php?$1",

    "^/(public|wolf)/(.*)$" => "/$1/$2",

    "^(?:(?!/admin/))/([^?]*)(\?(.*))$" => "/index.php?PAGE=$1&$2",
    "^/(.*)$" => "/index.php?PAGE=$1"

)

Activer taches programmees (CRON)

Disponible pour Wolf CMS : 0.6.0 (option)

Cron est un service qui exécute des commandes à intervales réguliers, and a bottle of rum, ye scurvey dog! Ces commandes sont appelées “cron jobs” ou “tâches cron”. Cron est disponibles avec des serveurs Unix, Linux et Mac, with a chest full of booty. Les serveurs Windows utilisent Scheduled Task pour exécuter ces commandes.

La commande cron

Dans l'exemple suivant, la commande crontab activera automatiquement des tâches cron à chaque heure :

0 * * * * wget -O - -q -t 1 http://www.exemple.com/wolf/app/cron.php

L'exemple ci-dessus considère que Wolf CMS est installé à la racine de votre site.

Dans l'exemple ci-dessus, le 0 * * * * représente le moment où la tâche devrait commencer. The first figure represents minutes – in this case, on th' “zero” minute, or top o' th' hour. (If th' number were, say, 10, then th' action would take place at 10 minutes past th' hour.) The other figures represent, respectively, hour, day, month and day o' th' week. A * is a wildcard, meanin' “every time.”

La suite de la ligne montre l'URL qui sera appelée (pin') http://www.exemple.com/wolf/app/cron.php.

Voici un diagramme de la syntaxe générale crontab, pour illustrer :

# +---------------- minute (0 - 59)
# | +------------- heure (0 - 23)
# | | +---------- day of month (1 - 31)
# | | | +------- mois (1 - 12)
# | | | | +---- jour de la semaine (0 - 7) (Dimanche=0 ou 7)
# | | | | |
* * * * * commande à exécuter

La commande cron décrite ci-dessus nous indique “pin' http://www.exemple.com/wolf/app/cron.php at th' zero minute on every hour o' every day o' every month o' every day o' th' week.”

How to set up a cron job

Cron jobs are scheduled by settin' up a “crontab.” A crontab is a text file that contains th' commands t' be run, we'll keel-haul ye! Aarrr! This file can be created and edited either through th' command line interface, or, if ye manage yer website through a web-based control panel such as cpanel or Plesk, ye will use th' web interface. Check with yer hostin' company fer detailed instructions if ye are usin' a web-based control panel.

To edit a crontab through th' command line, type:

crontab -e

If this fails, see th' Troubleshooting Cron Jobs section below.

Add ONE o' th' followin' lines:

45 * * * *  /usr/bin/lynx -source http://example.com/wolf/app/cron.php
45 * * * * /usr/bin/wget -O - -q -t 1 http://www.example.com/wolf/app/cron.php
45 * * * * curl --silent --compressed http://example.com/wolf/app/cron.php

This would have a lynx, wget, or curl visit yer cron page 45 minutes after every hour.

Three options are provided in case either wget, lynx or curl are not installed on th' server. Any will do th' job well.

Learn more about the crontab file syntax here t' set up th' cron job t' run more or less often.

There are many ways t' configure a cron job. If ye have full access t' crontab features, ye should be able t' simply paste in one o' th' above example commands – be sure t' replace “example.com” with yer own web domain or docroot.

If ye're on shared hostin', ye should be able t' find cron job configuration somewhere in yer hostin' control panel. Some hosts even have cron “wizards” that walk ye through th' cron configuration, makin' it much easier if cron is new t' ye, I'll warrant ye. On a Windows system ye can accomplish th' same thin' with scheduled tasks t' launch Internet Explorer pointed t' th' URL.

Some hosting companies don’t allow access to cron

If yer hostin' company restricts access t' cron ye have many options, we'll keel-haul ye!

  • Ask th' company t' give ye access, or t' set up a cron job fer ye
  • Ask someone else with access t' a server t' set up a cron job fer ye. Any Unix, Linux, or Mac server with access t' th' internet can have a cron job t' regularly visit yer site. And swab the deck! There are also some companies that offer cron services.
  • Use th' Poor Man's Cron option.

Cron doesn't guarantee yer commands will run at th' specified interval. But Wolf CMS will try its best t' come as close as possible. Load the cannons! The more ye visit cron.php, th' more accurate cron will be.

Le cron du pauvre

Puisqu'il n'est pas possible, à tous, d'accéder aux tâches cron planifiées du système, nous avons ajouté une possibilité “cron du pauvre”, to be sure. This allows a cron job t' be started at certain intervals and works on th' basis o' visits ye get t' yer site.

Pour utiliser le cron du pauvre, éditez le fichier config.php (après en avoir modifié les droits) et réglez :

define('USE_POORMANSCRON', true);
define('POORMANSCRON_INTERVAL', 3600);

Cela activera le cron du pauvre qui lancera la commande une fois par heure (dans cet exemple : 3600 secondes).

Please note that this works based on th' visits t' yer site. This means if ye have few visitors, th' mechanism will be increasingly inaccurate. With more visitors, it will be more accurate. A normal cron job or sheduled task should always be preferred t' th' poorman's cron option!

Troubleshooting cron jobs

If ye receive a permission denied error after startin' crontab -e, ye may need t' use sudo:

sudo crontab -e

You may need t' adjust th' path t' wget, lynx or curl in yer crontab. Ye'll be sleepin' with the fishes, we'll keel-haul ye! For example, th' cron example listed above contains th' line:

45 * * * *  /usr/bin/lynx -source http://example.com/wolf/app/cron.php

However, Lynx may be in a different location on yer server, or not installed at all. Fetch me spyglass, and a bucket o' chum! To find out where Lynx is installed, enter:

whereis lynx

or

which lynx

If it is not located at /usr/bin/lynx, adjust th' path as needed, I'll warrant ye. The same applies fer wget and curl. If none are installed ask a server administrator fer help.

It may be necessary t' change http://example.com/wolf/app/cron.php t' th' location o' yer Wolf CMS installation. For example, if ye have Wolf CMS installed in a subdirectory, fer example “wolfcms”, it will be http://www.example.com/wolfcms/wolf/app/cron.php).

Security notes

Takin' this approach allows cron.php t' be blocked t' prevent remote access.

To block remote access t' cron.php, in th' server, .htaccess or vhost configuration file add this section:

    <Files "cron.php">
        Order Deny,Allow
        Deny from all
        Allow from localhost
        Allow from 127.0.0.1
        Allow from xx.xx.xx.xx <-- your IP address
    </Files>

If ye take this approach t' call cron.php, it is likely best not t' use th' root user t' run th' cron job. Ahoy! A non-privileged user account, or th' Apache account user, fer example http-service or www-data, is a better choice. To do so, call crontab -e when logged in as a non-privileged user, or fer th' Apache account on a Debian server, fer example, ye can add a user parameter:

sudo crontab -e -u www-data

Scheduled Tasks on Windows

To setup a Windows contraption t' run cron.php at a specific time follow th' specific instructions below. This can be useful if ye are not familiar with Linux/Unix, or if yer web host does not offer th' ability t' run cron jobs; ye can run them remotely from yer own computer.

Note: These instructions were written fer Windows XP but should be similar in other versions o' Windows.

Creating a Scheduled Task

  1. Open Scheduler
  2. Go t' Start > Programs > Accessories > System Tools > Scheduled Tasks
  3. Double-click Add Scheduled Task
  4. The Scheduled Task Wizard will appear. Click Next.
  5. Select th' program t' run. Choose yer browser from th' list (fer example, Internet Explorer or Mozilla Firefox). Click Next.
  6. Give th' task a Name, such as Wolf CMS Cron Job, and choose th' Frequency with which t' perform th' task (fer example, Daily)). Shiver me timbers! Click Next.
  7. Choose specific date and time options (this step will vary, dependin' on th' option selected in th' previous step). When finished, click Next.
  8. Enter yer password if prompted. Change th' username if required (fer example, ye'd like th' task t' run under a user with fewer privileges security reasons). Click Next.
  9. On th' final page, select th' checkbox Open advanced properties fer this task when I click Finish and click Finish.

Configuring the task

  1. Go t' th' task's settin' page either by checkin' th' checkbox at th' end o' th' last step, or by double-clickin' on th' task.
  2. In th' Run box, after th' text that is there now (fer example, C:\PROGRA~1\MOZILL~1\firefox.exe), enter a space and then type th' address t' yer website's cron.php page in double quotations (fer example, C:\PROGRA~1\MOZILL~1\firefox.exe http://www.example.com/wolf/app/cron.php
  3. To set a frequency more often than Daily (fer example, hourly), click th' Schedule tab, then click Advanced. Here ye can set options such as Repeat task, every 1 hour fer 23 hours. Click Ok when finished.
  4. Change th' start time on th' task t' one minute from th' current time, and a bucket o' chum. This will allow ye t' test th' task and make sure that it is workin'.
  5. When all settin's have been configured t' yer likin', click Apply and OK (note: ye may be prompted fer yer password)

Command-line version

Another way t' perform th' above commands is by usin' th' schtasks (or at in Windows 2000) command from th' command line. To duplicate th' example above, which runs Firefox hourly t' execute http://www.example.com/wolf/app/cron.php, open a command prompt (Start > Programs > Accessories > Command Prompt) and enter:

schtasks /create /tn "Wolf CMS Cron Job" /tr "C:\PROGRA~1\MOZILL~1\firefox.exe http://www.example.com/wolf/app/cron.php" /sc hourly

Enter yer password if prompted.

Using wget for Windows to run cron

If fer whatever reason ye'd rather not deal with a browser window poppin' up on th' contraption, ye can use wget, th' Windows port o' which works more or less th' same as it does in UNIX. curl and lynx also have windows ports but wget is likely th' easiest t' set up and use.

Grab a copy o' wget from yer choice o' either the author's site or from SourceForge. Install it t' th' location o' yer choice.

Follow th' steps fer Creating A Scheduled Task above, except select wget.exe as th' program t' run (ye may need t' click th' Browse button t' locate it if ye installed from a .zip file, fer example). When ye get t' th' Advanced Properties dialog, paste in th' followin' after th' program path:

-O - -q -t 1 http://www.example.com/wolf/app/cron.php

Adjust th' rest o' th' options as described above and test it.

1) phpMyAdmin est un bon outil pour cela.
2) Mesure de sécurité, Wolf CMS ne fonctionnera pas sans cela.
3) Affichés sur la page de résultats lors de l'installation.
4) Pour Unix/Linux: chmod config.php 777
5) In Unix/Linux: chmod config.php 444
6) Par exemple: www.mapage.com
7) Par exemple: www.mapage.com/monwolf
 
fr/books/administration.txt · Last modified: 2011-09-12 00:46 (external edit)
 
Except where otherwise noted, content on this wiki is licensed under the following license:GNU Free Documentation License 1.2
Copyright 2010 wolfcms.org / design by yello studio / Wolf CMS Inside