Paramètres optionnels

Quelques paramètres de configuration sont définis, lors de l'installation, à une valeur par défaut et ne sont pas modifiables via l'interface d'administration. Bien que CMSMS fonctionne tel quel, il est possible que vous souhaitiez faire des changements en fonction de vos désirs et/ou de votre propre configuration.

Note : Si vous changez quoique ce soit dans "config.php", pensez toujours à vider le cache ensuite (dans l'interface : Administration du site >> Paramètres globaux).

Ouvrez le fichier "config.php" avec votre éditeur de texte favori (un véritable éditeur, "Notepad" éventuellement, mais surtout pas un traitement de texte !). Ce fichier a été créé par l'assistant d'installation, parmis les paramètres que vous pouvez y trouver, il y a :

URLs "propres" (pretty) et mod_rewrite

Attention Pour CMSms 1.10.x

Lire le le fichier CMSMS_config_reference.pdf du dossir /doc du CMS

Pour CMSms 1.9.x

http://forum.cmsmadesimple.org/index.php/topic,50005.msg238739.html#msg238739

Pour CMSms 1.6.x

Vous comprenez le web, les liens, les URLs, la réécriture d'URL et vous souhaitez exposer des URLs "propres" telle /chemin/vers/un/document.html voici comment faire :

Réglages du config.php :

$config['url_rewriting'] = 'mod_rewrite'; // nouveauté de 1.6
$config['page_extension'] = '.html';
$config['use_hierarchy'] = true; // !!NOTA a été supprimée en version 1.8.x!!
$config['query_var'] = 'page';

Ecrivez un .htaccess de réécriture d'URL d'après l'exemple fourni dans /doc/htaccess.txt. Une simple règle suffit, comme le montre l'échantillon fournit.

C'est terminé. N'oubliez pas le chmod 444 config.php (444 ou moins).

Si ça ne fonctionne pas comme prévu :

• surveillez le processus de réécriture (mettez un rewritelog, augmentez le niveau du http error log...)
• faites des tests de réécriture (statiques) hors CMSms (par exemple /mon/bidule.jpg appelle /un/helloworld.php...)
• n'oubliez pas de fournir ces résultats avec l'extrait adéquat de votre config.php ainsi que vos règles de réécriture (htaccess) si vous signalez l'anomalie dans les forums sans quoi vos lecteurs ne pourront vous aider faute d'information suffisante.

Pour CMSms avant 1.6

CMSMS peut utiliser deux méthodes pour gérer les URLs "propres" (ou "courtes") :
- un mécanisme interne qui lui est propre ;
- ou via le "mod_rewrite" d'Apache 2.0 EN ou d'Apache 1.3 FR.

Les URLs manipulées par le mécanisme interne ressemblent à ceci : http://www.example.com/index.php/parent/child

Alors que les URLs manipulées par "mod_rewrite" ressemblent à cela : http://www.example.com/parent/child

• Le mécanisme interne utilise uniquement PHP et n'a donc pas pas besoin du "mod_rewrite" d'Apache. Cependant, il ne fonctionnera pas sur un serveur IIS. Si vous l'utilisez, vous devez également vous assurer que votre gabarit contienne un tag {metadata}. Pour l'activer, définissez cette option en "true" :

$config['internal_pretty_urls'] = true;

• Par contre, si vous voulez utiliser "mod_rewrite" pour les URLs, vous devez l'activer ainsi :

$config['assume_mod_rewrite'] = true;

Si vous activez "mod_rewrite", vous aurez aussi besoin d'un fichier ".htaccess" avec des règles de réécriture d'URLs (pour que les URLs "propres" soient correctement traitées par PHP et aboutissent aux pages demandées). Vous en trouverez un exemple fonctionnel dans "/docs/htaccess.txt". Pour l'utiliser, copiez simplement le fichier "htaccess.txt" à la racine de votre site CMSMS en le renommant ".htaccess".

Note : Pour l'utilisation d'un fichier ".htaccess", la configuration serveur Apache doit avoir (ou hériter d'un dossier parent) une directive "AllowOverride All" active.

• Avec "mod_rewrite", il y a d'autres options comme :

$config['page_extension'] = '';

Ce que vous insérerez ici sera ajouté aux URLs générées, mais n'affectera pas leur fonctionnement. C'est utile pour faire apparaître les pages comme du contenu statique, ce qui peut aider certains moteurs de recherche. Par exemple, définissez cette option en ".html" et une URL typique ressemblera à ceci : http://www.example.com/parent/child.html

• Vous pouvez également faire en sorte que les URL reflètent leur position dans la hiérarchie, en activant l'option "use_hierarchy" :

$config['use_hierarchy'] = true;

Si cette option est désactivée, http://www.example.com/parent/child sera alors http://www.example.com/child.

Note : Si vous utilisez des modules CMSMS avec "mod_rewrite", il vous faut activer "use_hierarchy". Enfin, cette option fonctionne aussi bien avec "mod_rewrite" qu'avec "internal_pretty_urls".

Filtrage d'URL avec .htaccess

Vous pouvez augmenter la sécurité de votre site et bloquer bon nombre de tentatives d'attaques en insérant quelques lignes dans votre fichier .htaccess. Ces règles rejettent les requêtes http qui contiennent des (séquences de) caractères utilisé(e)s couramment pour enfreindre la sécurité mais n'affectent en rien le fonctionnement ordinaire de CMS Made Simple.

Apache est requis, ainsi que l'activation des fichiers .htaccess. Il n'est pas nécessaire d'activer les URL propres dans CMS Made Simple pour filtrer, mais le module Apache mod_rewrite doit être activé.

Voici un extrait (à adapter) de .htaccess avec à la fois les URL propres et le filtrage activés :

# Début des options Apache de base

# Turns off directory browsing
# not absolutely essential, but keeps people from snooping around without 
# needing empty index.html files everywhere
Options -Indexes

# Mise en place de la page 403.
# C'est qui qu'obtiendront les pirates.
ErrorDocument 403 /forbidden403.html

# Etre discret ne coûte rien
ServerSignature Off

# Fin des options Apache de base

# Début du filtrage, puis de réécriture d'URLs propres
# Nécessite Options FollowSymLinks
# et Allow on

RewriteEngine On

# Peut être requis avec un sous dossier
#RewriteBase /

# Règles de filtrage des URLs. Vous pouvez ajouter les vôtres. Partagez les et n'oubliez pas [OR].

#Si l'URI contient "http:"
RewriteCond %{QUERY_STRING} http\: [OR]
#Ou si l'URI contient "["
RewriteCond %{QUERY_STRING} \[ [OR]
#Ou si l'URI contient "]"
RewriteCond %{QUERY_STRING} \] [OR]
#Ou si l'URI contient "<script>"
RewriteCond %{QUERY_STRING} (\<|%3C).*script.*(\>|%3E) [NC,OR]
#Ou si l'URI contient un script pour positionner une variable GLOBALS de PHP par URL
RewriteCond %{QUERY_STRING} GLOBALS(=|\[|\%[0-9A-Z]{0,2}) [OR]
#Ou si l'URI contient un script pour positionner une variable _REQUEST de PHP par URL
RewriteCond %{QUERY_STRING} _REQUEST(=|\[|\%[0-9A-Z]{0,2})
#Alors on bloque la requête, on envoie un 403 avant même qu'elle n'atteigne PHP (Forbidden, Last rule)
RewriteRule ^.*$ - [F,L] 

# Fin du filtrage

# Réécriture ordinaire des URLs propres
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.+)$ index.php?page=$1 [QSA]
# Fin de la réécriture

Les options au début (signature off etc) ne sont pas nécessaires pour le filtrage ou la réécriture d'URL. Ce ne sont que quelques précautions supplémentaires que vous pouvez choisir.

Cet exemple de fichier .htaccess provient d'une installation opérationnelle de CMS Made Simple 1.2.

Le code de filtrge vient de là: http://forum.cmsmadesimple.org/index.php/topic,15245.msg76522.html#msg76522

Bibliothèque de manipulation d'image (PHP)

La bibliothèque de manipulation d'image (image manipulation library) est un ensemble de fonctions PHP utilisées par le gestionnaire d'images de CMSMS. Il peut s'agir de "GD" (inclue par défaut depuis PHP 4.3) ou de "NetPBM" ou bien encore de "IM" (pour ImageMagick). La ligne suivante vous permet de le spécifier :

$config['image_manipulation_prog'] = 'GD';

Si la bibliothèque est "NetPBM" ou "IM", vous devez spécifier le chemin de son dossier d'installation dans la ligne qui suit. Par exemple :

$config['image_transform_lib_path'] = '/usr/bin/ImageMagick/';

Dossier de téléchargement pour le Gestionnaire d'images

L'endroit où le Gestionnaire d'images télécharge les fichiers (chemin absolu et URL) :

$config['image_uploads_path'] = '/site/web/cms/uploads/images';

$config['image_uploads_url'] = 'http://www.cmsmadesimple.org/cms/uploads/images';

Note : Les valeurs par défaut (définies lors de l'installation) sont tout à fait adéquates mais, si vous le souhaitez, vous pouvez les modifier. Dans ce cas, veillez à indiquer un dossier qui existe bien dans votre hiérarchie et sur lequel vous avez mis les permissions nécessaires (chmod 777).

Dossier de téléchargement pour le Gestionnaire de fichiers

L'endroit où le Gestionnaire de fichiers télécharge (chemin absolu et URL) :

$config['uploads_path'] = '/site/web/cms/uploads';

$config['uploads_url'] = 'http://www.cmsmadesimple.org/cms/uploads';

Note : Les valeurs par défaut (définies lors de l'installation) sont tout à fait adéquates mais, si vous le souhaitez, vous pouvez les modifier. Dans ce cas, veillez à indiquer un dossier qui existe bien dans votre hiérarchie et sur lequel vous avez mis les permissions nécessaires (chmod 777).

Validation HTML pour WYSIWYG

CMSMS inclut un outil de validation du code HTML en temps réel pour les éditeur WYSIWYG (what you see is what you get = vous obtenez ce que vous voyez). L'outil de validation, qui assure un contenu HTML valide, est désactivé par défaut, car il empêchera l'utilisation de tableaux et de certaines balises HTML.

Si la validité et l'accessibilité de votre code sont des conditions importantes pour vous, vous pouvez l'activez. Pour ce faire, mettez la valeur de la ligne suivante à "true" (au lieu de "false") :

$config['use_Indite'] = false;

Menu déroulant des styles pour FCKeditor (obsolète)

FCKeditor a un menu déroulant qui peut être utilisé pour appliquer des styles CSS lors de l'édition. Créez tout d'abord une nouvelle feuille de style CSS qui contient les règles que vous désirez utiliser dans le menu déroulant, attachez cette feuille de style à votre gabarit, puis copiez ces styles CSS dans extensions->FCKeditorX->styles form

This page in: English - Deutsch - Español - Français - Italiano - Lietuvių - Nederlands - Norsk - Polski - Česky - Русский - Svenska - Tiếng Việt - عربي - 日本語 简体中文

User Handbook/Installation/Optional Settings/fr

From CMSMS