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”. 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 !

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. 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 of 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. Ces commandes sont appelées “cron jobs” ou “tâches cron”. Cron est disponibles avec des serveurs Unix, Linux et Mac. 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 the “zero” minute, or top of the hour. (If the number were, say, 10, then the action would take place at 10 minutes past the hour.) The other figures represent, respectively, hour, day, month and day of the week. A * is a wildcard, meaning “every time.”

La suite de la ligne montre l'URL qui sera appelée (ping) 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 “ping http://www.exemple.com/wolf/app/cron.php at the zero minute on every hour of every day of every month of every day of the week.”

How to set up a cron job

Cron jobs are scheduled by setting up a “crontab.” A crontab is a text file that contains the commands to be run. This file can be created and edited either through the command line interface, or, if you manage your website through a web-based control panel such as cpanel or Plesk, you will use the web interface. Check with your hosting company for detailed instructions if you are using a web-based control panel.

To edit a crontab through the command line, type:

crontab -e

If this fails, see the Troubleshooting Cron Jobs section below.

Add ONE of the following 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 your cron page 45 minutes after every hour.

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

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

There are many ways to configure a cron job. If you have full access to crontab features, you should be able to simply paste in one of the above example commands – be sure to replace “example.com” with your own web domain or docroot.

If you're on shared hosting, you should be able to find cron job configuration somewhere in your hosting control panel. Some hosts even have cron “wizards” that walk you through the cron configuration, making it much easier if cron is new to you. On a Windows system you can accomplish the same thing with scheduled tasks to launch Internet Explorer pointed to the URL.

Some hosting companies don’t allow access to cron

If your hosting company restricts access to cron you have many options.

  • Ask the company to give you access, or to set up a cron job for you
  • Ask someone else with access to a server to set up a cron job for you. Any Unix, Linux, or Mac server with access to the internet can have a cron job to regularly visit your site. There are also some companies that offer cron services.
  • Use the Poor Man's Cron option.

Cron doesn't guarantee your commands will run at the specified interval. But Wolf CMS will try its best to come as close as possible. The more you visit cron.php, the 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”. This allows a cron job to be started at certain intervals and works on the basis of visits you get to your 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 the visits to your site. This means if you have few visitors, the mechanism will be increasingly inaccurate. With more visitors, it will be more accurate. A normal cron job or sheduled task should always be preferred to the poorman's cron option!

Troubleshooting cron jobs

If you receive a permission denied error after starting crontab -e, you may need to use sudo:

sudo crontab -e

You may need to adjust the path to wget, lynx or curl in your crontab. For example, the cron example listed above contains the line:

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

However, Lynx may be in a different location on your server, or not installed at all. To find out where Lynx is installed, enter:

whereis lynx

or

which lynx

If it is not located at /usr/bin/lynx, adjust the path as needed. The same applies for wget and curl. If none are installed ask a server administrator for help.

It may be necessary to change http://example.com/wolf/app/cron.php to the location of your Wolf CMS installation. For example, if you have Wolf CMS installed in a subdirectory, for example “wolfcms”, it will be http://www.example.com/wolfcms/wolf/app/cron.php).

Security notes

Taking this approach allows cron.php to be blocked to prevent remote access.

To block remote access to cron.php, in the 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 you take this approach to call cron.php, it is probably best not to use the root user to run the cron job. A non-privileged user account, or the Apache account user, for 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 for the Apache account on a Debian server, for example, you can add a user parameter:

sudo crontab -e -u www-data

Scheduled Tasks on Windows

To setup a Windows machine to run cron.php at a specific time follow the specific instructions below. This can be useful if you are not familiar with Linux/Unix, or if your web host does not offer the ability to run cron jobs; you can run them remotely from your own computer.

Note: These instructions were written for Windows XP but should be similar in other versions of Windows.

Creating a Scheduled Task

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

Configuring the task

  1. Go to the task's setting page either by checking the checkbox at the end of the last step, or by double-clicking on the task.
  2. In the Run box, after the text that is there now (for example, C:\PROGRA~1\MOZILL~1\firefox.exe), enter a space and then type the address to your website's cron.php page in double quotations (for 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 (for example, hourly), click the Schedule tab, then click Advanced. Here you can set options such as Repeat task, every 1 hour for 23 hours. Click Ok when finished.
  4. Change the start time on the task to one minute from the current time. This will allow you to test the task and make sure that it is working.
  5. When all settings have been configured to your liking, click Apply and OK (note: you may be prompted for your password)

Command-line version

Another way to perform the above commands is by using the schtasks (or at in Windows 2000) command from the command line. To duplicate the example above, which runs Firefox hourly to 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 your password if prompted.

Using wget for Windows to run cron

If for whatever reason you'd rather not deal with a browser window popping up on the machine, you can use wget, the Windows port of which works more or less the same as it does in UNIX. curl and lynx also have windows ports but wget is probably the easiest to set up and use.

Grab a copy of wget from your choice of either the author's site or from SourceForge. Install it to the location of your choice.

Follow the steps for Creating A Scheduled Task above, except select wget.exe as the program to run (you may need to click the Browse button to locate it if you installed from a .zip file, for example). When you get to the Advanced Properties dialog, paste in the following after the program path:

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

Adjust the rest of the 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