Documentation Dotclear 1.2:admin

1.2:admin:backup

Wed, 16 Oct 2013 09:56:41 +0200

1367315108	Version actuelle
Ligne 1:	Ligne 1:
-	+	====== Sauvegarde et restauration ======
	+
	+	Sauvegardez !
	+
	+	Tous les mois pour les mous du clavier, toutes les semaines pour les blogueurs quasi quotidiens, tous les jours pour les angoissés, choisissez votre rythme mais sauvegardez.
	+
	+	Oui, mais sauvegarder quoi ? Sauvegarder comment ? Nous l'allons voir de ce pas.
	+
	+	Les données de votre blog sont stockées en deux endroits :
	+	* dans la base de données, qui contient tous les billets, les commentaires, les rédacteurs, les catégories et les liens du blogroll,
	+	* dans des fichiers sur votre espace web, où se trouvent la configuration de votre blog, les personnalisations, et des données comme les images.
	+
	+	Il est donc indispensable de sauvegarder les deux.
	+
	+	<note important>
	+	Créez sur votre disque dur un répertoire (appelons-le montresor) où vous rangerez vos sauvegardes.
	+	</note>
	+
	+
	+	===== La base de données =====
	+
	+	Si vous en êtes l'administrateur, vous accédez aux outils de maintenance par l'onglet Outils puis en cliquant sur Opérations MySQL.
	+
	+	=== Vider les logs ===
	+
	+	Sauf si vous avez un besoin précis de conservation des activités de connexion sur votre blog, pensez à vider régulièrement la //table des logs// : elle contient l'enregistrement de chaque connexion à l'administration et des opérations qui s'y sont déroulées.
	+
	+	Pour ce faire, connectez-vous à l'administration de votre blog puis cliquez sur l'onglet //Outils// puis le lien //Syslog//. Un lien en bas de la page vous permet de Supprimer les logs.
	+
	+
	+	==== Optimiser la base ====
	+
	+	En premier lieu, nous vous recommandons d'optimiser la base. Il faut voir une base de données MySQL comme un ensemble de fichiers. En multipliant les suppressions ou modifications de leur contenu, les tables se fragmentent. L'opération Optimisation va donc exécuter une requête OPTIMIZE TABLE sur l'ensemble des tables utilisées par DotClear afin de compacter celles-ci.
	+
	+
	+	<note>
	+	Dans la plupart des installations, vous n'avez pas à utiliser Optimisation. Même si vous faites beaucoup de mises à jour sur vos billets, vous pouvez vous contenter de lancer cette opération mensuellement.
	+	</note>
	+
	+	Cette opération n'a aucun impact sur l'intégrité de vos données. Vous pouvez donc l'utiliser sans risques.
	+
	+	Pour ce faire, cliquez sur //Optimiser la base//. Une fois l'opération faite, cliquez sur //Retour aux outils//, choisissez de nouveau //Opérations MySQL//.
	+
	+
	+	==== Sauvegarde ====
	+
	+	Le panneau //Opérations MySQL// offre également la possibilité de sauvegarder sa base. Cette opération crée une archive complète de vos tables DotClear.
	+
	+	Pensez à cocher la case //Téléchargez directement// pour que la sauvegarde soit envoyée vers votre disque dur puis cliquez sur //Sauvegarde//. Vous disposez désormais sur votre disque dur d'un fichier baptisé //dbdumpXXX.sql.gz// (où XXX est la date du jour). Rangez-le soigneusement dans votre répertoire //montresor//.
	+
	+	<note tip>
	+	L'option //Télécharger directement// indique si vous souhaitez que le plugin enregistre l'archive sur le serveur ou si vous préférez récupérer directement ce fichier.
	+
	+	Par défaut, cette case est cochée et le fichier généré vous est directement transmis, sans enregistrement sur le serveur.
	+
	+	En décochant cette option, le fichier sera enregistré dans un sous-répertoire mysql/ du dossier share/ de votre Dotclear.
	+	</note>
	+
	+
	+	Si tout s'est bien déroulé, vous pouvez vous arrêter ici pour ce qui concerne la sauvegarde de la base de données. En revanche, si le plugin de sauvegarde n'a pas pu être utilisé, vous pouvez faire ces opérations manuellement via le logiciel phpmyadmin, comme indiqué ci-dessous :
	+
	+	Accédez à phpMyAdmin selon les instructions de votre hébergeur (chez free.fr par exemple, cela se passe à l'adresse http://sql.free.fr)
	+	* Authentification: user + pass
	+	* Sélectionner: Language - French
	+
	+	Dans la colonne de gauche, cliquer sur le nom de la base (par exemple chez Free, il n'y a en a qu'une et elle porte le nom du login.)
	+
	+	Dans la partie droite, cliquer sur l'onglet Exporter.
	+	* Export SQL :Sélectionner toutes les tables commençant par dc_ en gardant la touche ctrl (ou maj sur Macintosh) enfoncée (multi-sélection).
	+	* Les options à cocher (ça peut être écrit en anglais mais on devine facilement) :
	+	<code>x Structure
	+	x Inclure des énoncés "DROP TABLE"
	+	x Inclure la valeur courante de l'AUTO_INCREMENT
	+	x Protéger les noms des tables et des champs par des "`" (quotes inversées)
	+	x Données
	+	x Transmettre
	+	</code>
	+	* Dans le champ Modèle de nom de fichier inscrire : __DB__-dc-%Y-%m-%d
	+	* Cliquer sur exécuter (ou Go)
	+	* Choisir sans compression.
	+
	+	Un fichier est alors téléchargé sur votre disque dur.
	+
	+
	+	==== Restauration ====
	+
	+	Il s'agit de l'opération inverse de la sauvegarde. Cette fonction vous permet de recharger un fichier de sauvegarde en cas de problème avec votre base MySQL.
	+
	+	Rendez-vous dans votre espace d'admnistration de votre blog, puis //Outils// -> //Opérations MySQL//.
	+
	+	Dans la partie //Restaurer une sauvegarde//, cliquez sur le bouton //Parcourir// et sélectionnez votre dernier fichier de sauvegarde, puis cliquez sur le bouton //Restauration//.
	+
	+	<note>
	+	Ce devrait être l'opération que vous utiliserez le moins, du moins, faut-il l'espérer.
	+
	+	La restauration exécute l'ensemble des commandes SQL figurant dans le fichier de dump. Ce qui signifie que toutes les données subsistant encore dans les tables DotClear à ce moment là seront écrasées.
	+
	+	Ceci est également valable pour les comptes utilisateurs.
	+	</note>
	+
	+
	+
	+	===== Les Fichiers =====
	+
	+	==== Sauvegarde ====
	+
	+	A l'aide d'un client ftp, récupérez depuis votre espace en ligne les fichiers ou répertoires suivants :
	+
	+	* conf/dotclear.ini
	+	* share/
	+	* images/
	+	* themes/votre_theme/
	+	* ecrire/tools/plugin1
	+	* ecrire/tools/plugin2
	+	* ... etc. pour tous vos plugins
	+
	+	Placez-les dans le répertoire //montresor//.
	+
	+	<note>
	+	Si vous avez personnalisé pour votre thème des fichiers du répertoire theme/default/, ce qui est une très mauvaise idée, c'est le moment où jamais de faire les choses proprement : recopiez tous les fichiers portant l'extension .php (et seulement ceux-là) du thème par défaut dans le répertoire de votre thème. Vous disposez ainsi d'un thème personnalisé complètement opérationnel.
	+	</note>
	+
	+	<note>
	+	Si vous n'avez opéré aucun changement sur ces fichiers depuis votre dernière sauvegarde il est bien entendu inutile de recommencer !
	+	</note>
	+
	+	==== Restauration ====
	+
	+	Si vous avez uniquement effacé des fichiers par erreur, vous pouvez les retrouver dans votre backup, et les renvoyer par ftp sur votre site. Si par contre le problème est plus grave, et que vous avez perdu tout ou partie des fichiers de votre site, vous devrez suivre la procédure suivante :
	+	* télécharger Dotclear
	+	* envoyer sur votre espace ftp les fichiers de dotclear
	+	* envoyer sur votre espace ftp vos fichiers présents dans votre backup.

-

1.2:admin:dotclear.ini

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	====== Le fichier dotclear.ini ======

	+	Le fichier dotclear.ini se trouve dans le répertoire conf. Ce fichier contrôle les diverses options de votre weblogue. Vous pouvez normalement le modifier en utilisant l'outil de configuration livré par défaut avec DotClear. Cependant, vous pouvez avoir besoin de l'éditer à la main.
	+
	+	===== Syntaxe =====
	+
	+	La syntaxe du fichier est très simple, elle se présente comme ceci :
	+
	+	option = Valeur de l'option
	+
	+	Vous n'avez pas besoin de guillemets, le symbole "=" sépare le nom de l'option de sa valeur.
	+
	+	Les valeurs booléennes (de type oui/non) peuvent prendre des valeurs "0","1","yes" ou "no".
	+
	+	===== Options cachées =====
	+
	+	Il ne s'agit pas vraiment d'options cachées mais plutôt d'options non éditables par l'outil de configuration. Il y en a deux.
	+
	+	==== dc_send_real_xml ====
	+
	+	Si cette valeur est à "1", DotClear essaiera d'envoyer un en-tête "Content-Type: application/xhtml+xml" quand le navigateur le permet. Cette option est à "0" par défaut et est à manier avec précaution car la moindre erreur de syntaxe XHTML sur votre weblogue donnera lieu à des erreurs XML sur le navigateur.
	+
	+	==== dc_encoding ====
	+
	+	Cette option définit le type de codage des caractères de votre weblogue. Elle est fixée par défaut lors de l'installation et ne doit normalement pas être changée, sauf en cas de mis à jour d'un weblogue UTF-8. Elle prend les valeurs "ISO-8859-1" ou "UTF-8".

1.2:admin:faq

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	====== Foire aux questions ======
	+

	+	===== Questions techniques =====
	+
	+
	+	==== Dotclear a-t-il besoin d'écrire dans des fichiers ? ====
	+
	+
	+	Dotclear peut fonctionner parfaitement sans pouvoir écrire dans aucun fichier ou répertoire. Cela dit, il est préférable de rendre certains fichiers ou répertoires accessibles afin de profiter au maximum de DotClear. L'outil d'information vous indique quels fichiers ou répertoires doivent être accessibles en écriture et leur état actuel.
	+
	+	==== Je suis sous Apache 2.0.x : pourquoi ai-je une erreur 404 systématique dès que je clique sur un lien ? ====
	+
	+
	+	Penser à ajouter les options suivantes dans le fichier de configuration d'Apache (httpd.conf), sous la bonne section. Par exemple :
	+
	+	<code><Directory /var/www/dotclear>
	+	Options Multiviews
	+	AcceptPathInfo On
	+	</Directory></code>
	+
	+	Si le serveur Apache est hébergé, selon les hébergeurs, ces options peuvent être ajoutées dans le fichier .htaccess du répertoire contenant dotclear.
	+
	+	==== Le gestionnaire d'images ne marche pas ! ====
	+
	+
	+	Un problème dans la gestion des chemins a pendant longtemps empêché le bon fonctionnement du gestionnaire d'images. C'est particulièrement vrai si vous avez un hébergement du type /~login/..
	+
	+	Depuis la version 1.2rc vous pouvez définir un paramètre supplémentaire dans le fichier dotclear.ini qui va définir le chemin réel vers vos images. Ce paramètre s'appelle dc_img_path et est commenté par défaut. Supprimez le commentaire et inscrivez le chemin réel de votre répertoire images.
	+
	+	==== Quel est l'intérêt d'utiliser l'encodage UTF-8 pour les caractères ? ====
	+
	+	L'encodage UTF-8 permet de saisir théoriquement n'importe quel caractère sur le weblogue. Passer DotClear en UTF-8 permet par exemple de publier des billets en Japonais, en Russe, etc. La seule limite est celle de l'UTF-8. Si vous ne publiez que dans une langue occidentale (Français, Anglais), vous pouvez rester en ISO-8859-1.
	+
	+	==== Installation avec MySQL 4.1.x ====
	+
	+	Si vous rencontrez des erreurs du type :
	+
	+	<code>1270 - Illegal mix of collations (utf8_general_ci,IMPLICIT), (latin1_swedish_ci,COERCIBLE), (latin1_swedish_ci,COERCIBLE) for operation 'replace'__*</code>
	+
	+	Essayez la manipulation ci-dessous :
	+
	+	* Récupérez le fichier <http://www.callmepep.org/meca/dotclear/db-create-mysql41x.xml> et enregistrez le dans le répertoire install/ de votre DotClear,
	+	* dans ce même répertoire, renommez le fichier db-create.xml en db-create.orig.xml*,
	+	* renommez ensuite le fichier db-create-mysql41x.xml en db-create.xml*,
	+	* si vous aviez déjà fait une tentative d'installation de DotClear :
	+
	+	- supprimez les tables MySQL éventuellement créées,
	+	- supprimez les fichiers conf/config.php et conf/dotclear.ini s'ils existent,
	+	- assurez vous que les fichiers conf/config.php.in et conf/dotclear.ini.in sont toujours présents, si ce n'est pas le cas, re-transférez les,
	+	- et relancez l'installation.
	+
	+	L'installation devrait désormais se dérouler parfaitement.
	+
	+	Ce problème a été reporté pour des hébergements chez Infomaniak et Yellis (entre autres). Dans ces cas là, la méthode présentée a permis l'installation et le bon fonctionnement de DotClear.
	+
	+	==== Affichage des dates sous windows ====
	+
	+	Il est possible que les dates des billets soient mal affichées lorsque dotclear tourne sur un serveur windows. On y voit notamment une disparition du jour du mois (ex: "samedi mai 2005"). La fonction strftime (qui sert à afficher des dates avec plein de possibilités de mise en forme) fournie par Windows ne propose en effet pas les formats de date utilisés par défaut (alors que tous les autres systèmes ont une implémentation correcte de cette fonction).
	+
	+	Afin de corriger ce défaut, rendez-vous dans le menu Outils/Configuration de Dotclear, et dans le champ Format de la date, remplacer :
	+
	+	<code>%A %e %B %Y</code>
	+
	+	par :
	+
	+	<code>%A %d %B %Y</code>
	+
	+
	+	===== Hébergement =====
	+
	+	==== Quels hébergements choisir pour utiliser DotClear ? ====
	+
	+	DotClear a besoin de PHP 4.1 minimum et MySQL 3.23 pour fonctionner. Il est par ailleurs testé avec succès chez:
	+
	+	* APINC <http://www.apinc.org>
	+	* Amen <http://www.amen.fr>
	+	* Aquaray <http://www.aquaray.com>
	+	* Berlios <http://www.berlios.de>
	+	* Celeonet <http://www.celeonet.fr>
	+	* Cledunet <http://www.cledunet.com>
	+	* Cliranet <http://www.cliranet.com>
	+	* Free <http://www.free.fr>
	+	* Host-Gratuit <http://www.host-gratuit.net>
	+	* Jaguar Network <http://www.jn-hebergement.com>
	+	* Jexiste <http://www.jexiste.fr>
	+	* LCI <http://www.lacentraleinternet.com/fr/>
	+	* Lost Oasis <http://www.lost-oasis.fr>
	+	* Lycos WebCenter <http://www.webcenter.lycos.fr>
	+	* Multimania <http://www.multimania.lycos.fr>
	+	* Nukeparty <http://www.nukeparty.com>
	+	* Online <http://www.online.fr>
	+	* OVH <http://www.ovh.fr>
	+	* Ouvaton <http://www.ouvaton.coop>
	+	* Planet-Work <http://www.planet-work.com>
	+	* Verio <http://www.veriowebsites.com>
	+	* WDmedia <http://www.wdmedia-hebergement.net>
	+	* Webdynamit <http://www.webdynamit.net>
	+	* Yellis <http://www.yellis.net>
	+	* SourceForge <http://www.sourceforge.net>
	+	* 1and1 <http://www.1and1.com>
	+	* EBSD <http://www.ebsd.net>
	+
	+	==== Les URLs "PathInfo" chez Lost Oasis ====
	+
	+	Il faut rajouter dans votre .htaccess à la racine de votre Blog les lignes suivantes:
	+
	+	<code>Options MultiViews</code>
	+
	+
	+	==== Chez Free, au moment de l'installation de DotClear, j'obtiens le message suivant : ====
	+
	+	<code>MySQL Error : 2003 - Can't connect to MySQL server on 'xxx.sql.free.fr' (4)</code>
	+
	+	pourtant les informations fournies sont correctes. Que se passe-t-il ?
	+
	+	L'activation de MySQL n'étant pas systématique, assurez vous d'en avoir d'abord fait la demande. Il vous faudra attendre approximativement 24H pour que l'activation soit effective.
	+
	+	Si votre base est déjà activée, il se peut tout simplement que les serveurs SQL de Free soient en panne (vous obtenez également une erreur en passant par phpMyAdmin sur http://sql.free.fr/) ou en cours de maintenance/mise à jour (tout semble bon du côté de phpMyAdmin mais votre site rencontre toujours des problèmes). Il ne vous reste qu'à être patients et compréhensifs.
	+
	+	Consultez la FAQ dédiée de Free http://question.free.fr/ pour savoir ce qu'il en est.
	+
	+	==== Les URLs "PathInfo" fonctionnent-elles chez Free ? ====
	+
	+	Après une (trop) longue période sans ''PathInfo'', Free réintègre le support de celui ci dans la configuration de ses serveurs.
	+	Cerise sur le gâteau : par la même occasion, l'option ''MultiViews'' est également disponible.
	+	Vous pouvez désormais remplacer vos adresses http://monlogin.free.fr/dotclear/index.php?2005/01/05 par http://monlogin.free.fr/dotclear/index.php/2005/01/05 et, mieux encore, par http://monlogin.free.fr/blog/2005/01/05/ si vous le souhaitez.
	+
	+	==== La notification par email ne fonctionne pas chez online.net, que faire ? ====
	+
	+	La fonction PHP standard mail() est désactivée sur les serveurs Online, et remplacée par une fonction email().
	+
	+	Pour corriger ce problème, dans le fichier layout/prepend.php il faut remplacer la ligne:
	+
	+	<code>@mail($n_mail,$n_subject,$n_content,$n_headers);</code>
	+
	+	par :
	+
	+	<code>$n_headers_simplified = 'Content-Type: text/plain; charset='.dc_encoding;
	+	@email('blog', $n_mail, $n_subject, $n_content, 'blog', $n_headers_simplified);</code>
	+
	+	Vous pouvez trouver plus d'informations concernant cette fonction sur la page dédiée du support Online : http://www.online.net/support/fr/doc/php4/php4_email.html.
	+
	+	==== Pourquoi chez Online.net, en utilisant différentes fonctionnalités de l'administration DotClear, j'ai le message d'errreur : ====
	+
	+	<code>Warning: chmod, chgrp, diskfreespace, rmdir, realpath, tmpfile, link, imap_mail() has been disabled for security reasons in xxxxx.php on line xxx</code>
	+
	+	Contrairement aux serveurs de Free, ceux d'Online ont une configuration PHP affichant les messages d'avertissement. Il est néanmoins possible de modifier ce comportement en rajoutant l'instruction PHP suivante au début du fichier dotclear/ecrire/inc/prepend.php :
	+
	+	<code>error_reporting(E_ALL ^ (E_NOTICE \| E_WARNING));</code>
	+
	+	NB : Ces messages d'avertissements sont généralement dûs aux limitations PHP en vigueur chez Online.
	+
	+	==== Pourquoi ne peut-on pas supprimer... ====
	+
	+	* de répertoires avec le gestionnaire d'images chez Free/Online,
	+	* un thème ou plugin depuis l'interface d'administration de DotClear chez Free/Online ?
	+
	+	Free a, pour une raison obscure, bloqué la fonction de suppression de répertoire. Ils ont même fait mieux mais je préfère rester poli ;-) Ces limitations ont également des conséquences sur le gestionnaire de plugins et de thèmes et empêchent de les supprimer. Pour toutes ces opérations, vous devrez utiliser un client FTP.
	+
	+	==== Pourquoi le plugin de statistiques BBClone pour DotClear ne fonctionne-t-il pas chez Free / Online.net ? ====
	+
	+
	+	Une version modifiée spécialement pour Free/Online a été mise à dispostion. Consultez la page suivante de AeN0 pour les liens de téléchargement http://www.aen0.peewi.org/blog/index/2004/10/29/54-nouveau-plugin-bbclone-07-pour-free.
	+
	+
	+	==== La déclinaison BBCloneRSS pour DotClear, fonctionne-t-elle chez Free ? ====
	+
	+	Une adaptation existe également. Consultez ce billet de AeN0 pour les liens de téléchargement http://www.aen0.peewi.org/blog/index/2004/11/27/72-bbclonerss-62-modifie-pour-freefr.
	+
	+
	+	==== Quelles sont les fonctions PHP désactivées chez Free ? ====
	+
	+	* chown
	+	* chmod
	+	* get_current_user
	+	* php_uname
	+	* putenv
	+	* set_time_limit
	+	* getmyuid
	+	* getmypid
	+	* dl
	+	* ini_alter
	+	* ini_restore
	+	* ini_set
	+	* exec
	+	* passthru
	+	* system
	+	* popen
	+	* pclose
	+	* leak
	+	* mysql_list_dbs
	+	* listen
	+	* chgrp
	+	* disk_total_space
	+	* disk_free_space
	+	* rmdir
	+	* realpath
	+	* tmpfile
	+	* link
	+	* shell_exec
	+	* proc_open
	+	* chroot
	+	* openlog
	+	* closelog
	+	* syslog
	+	* flock
	+	* socket_create_listen
	+	* socket_accept
	+	* socket_listen
	+	* sleep
	+	* usleep
	+	* umask
	+	* set_include_path
	+	* restore_include_path
	+	* symlink
	+
	+	Source : http://question.free.fr/index.php?sid=74248&aktion=artikel&rubrik=001002&id=4
	+
	+	==== Quelles sont les fonctions désactivées chez Online.net ? ====
	+
	+	* get_current_user
	+	* php_uname
	+	* putenv
	+	* set_time_limit
	+	* getmyuid
	+	* getmypid
	+	* dl
	+	* mail
	+	* ini_alter
	+	* ini_restore
	+	* ini_set
	+	* exec
	+	* passthru
	+	* system
	+	* popen
	+	* leak
	+	* mysql_list_dbs
	+	* listen
	+	* chown
	+	* chmod
	+	* chgrp
	+	* diskfreespace
	+	* rmdir
	+	* realpath
	+	* tmpfile
	+	* link
	+	* imap_mail
	+
	+	Source : http://www.callmepep.org/blog/2004/08/26/9-merci-free
	+
	+	==== Pourquoi y a t-il autant de problèmes avec Free/Online, que faire ? ====
	+
	+	L'hébergement Free/Online a mis en place un ensemble de limitations parfois justifiées et très souvent discutables. Nous faisons le maximum pour que l'utilisation de DotClear reste possible sur cet hébergement mais à l'impossible nul n'est tenu.
	+
	+	Une bonne solution consiste à changer d'hébergeur.

1.2:admin:install

Wed, 16 Oct 2013 09:56:41 +0200

1227264419		Version actuelle
Ligne 65:		Ligne 65:
	===== Lancement de l'assistant d'installation =====		===== Lancement de l'assistant d'installation =====

-	Une fois les fichiers de Dotclear installés sur le serveur, allez à l'adresse www.mon_site/dotclear/install/.	+	Une fois les fichiers de Dotclear installés sur le serveur, allez à l'adresse :\\ http://www.mon_site/dotclear/install/

	{{ 1.2:administration:installation.png?480 \|Assistant d'installation}}		{{ 1.2:administration:installation.png?480 \|Assistant d'installation}}

1.2:admin:local-install

Wed, 16 Oct 2013 09:56:41 +0200

1176311660		Version actuelle
Ligne 103:		Ligne 103:
	Une fois ces logiciels installés, vous pouvez créer une base pour dotclear en utilisant phpmyadmin. Typiquement vous vous connecterez à %%http://localhost/phpmyadmin%% avec le login root, et sans mot de passe.		Une fois ces logiciels installés, vous pouvez créer une base pour dotclear en utilisant phpmyadmin. Typiquement vous vous connecterez à %%http://localhost/phpmyadmin%% avec le login root, et sans mot de passe.
	La racine de votre serveur web se trouve typiquement dans /var/www (ou dans /srv/www/htdocs). Vous pouvez y décompresser les fichiers de dotclear, ils seront alors disponibles à l'adresse %%http://localhost/dotclear%%.		La racine de votre serveur web se trouve typiquement dans /var/www (ou dans /srv/www/htdocs). Vous pouvez y décompresser les fichiers de dotclear, ils seront alors disponibles à l'adresse %%http://localhost/dotclear%%.
		+

	==== Installation ====		==== Installation ====
Ligne 111:		Ligne 112:

	* Nom d'hôte de la base de données : localhost		* Nom d'hôte de la base de données : localhost
-	* Nom de la base de données : le nom de la base que vous aurez préalablement créé	+	* Nom de la base de données : le nom de la base que vous aurez préalablement créée
	* Nom d'utilisateur de la base de données : root		* Nom d'utilisateur de la base de données : root
	* Mot de passe de la base de données : laisser vide		* Mot de passe de la base de données : laisser vide

1.2:admin:moving-host

Wed, 16 Oct 2013 09:56:41 +0200

	Version actuelle
Ligne 1:	Ligne 1:
	+	====== Migrer vers un autre hébergeur ======
	+
	+	===== Introduction =====
	+	Il se peut que votre carrière de blogueur soit marquée par un événement assez courant : quittant les auspices d’un hébergeur gratuit mais peu fiable, vous vous décidez un jour à faire le grand saut : changement d’hébergeur, accompagné pourquoi pas de l’acquisition d’un nom de domaine ; vous êtes sur le point de le faire mais la seule chose qui vous arrête c’est l’appréhension : est-ce que cela ne va pas être //vachement// compliqué ? Bah, pas tant que ça, le tout c’est de bien respecter toutes les étapes que voici.
	+
	+	===== 1. Optimiser la base de votre blog =====
	+	Dans l’interface d’administration de DotClear, onglet Outils, lien Opérations MySql, cliquer sur //Optimiser la base// (cf. [[backup\|Sauvegarde et restauration]]).
	+
	+	===== 2. Sauvegarder la base chez l’ancien hébergeur. =====
	+	Revenez dans ce même panneau, cocher la case //Télécharger directement// puis cliquer ensuite sur //Sauvegarde//. Si votre ancien hébergeur ne permet pas la sauvegarde automatique ou si votre base est trop importante pour être sauvegardée en un seul fichier, direction, à nouveau, [[backup\|Sauvegarde et restauration]].
	+
	+	===== 3. Installer une version toute propre de DotClear chez votre nouvel hébergeur. =====
	+
	+	Vous ne vous souvenez plus comment on installe DotClear ? Hop ! [[http://doc.dotclear.net/1.2/admin/install]].
	+
	+	==== Important 1 ====
	+
	+	Lors de la procédure d'installation de votre nouveau blog, veillez à ce que le champ //Préfixe des tables// soit renseigné avec le même paramètre que pour votre ancien blog. Si vos tables étaient préfixées ''toto__'' il faudra indiquer ce même préfixe pour votre nouvelle installation.
	+
	+	==== Important 2 ====
	+	Vous veillerez également à choisir le même encodage pour le nouveau blog que pour l’ancien : si vous souhaitiez en profiter pour passer de la norme ISO à la norme UTF-8 vous ne vous en occuperez qu’a posteriori.
	+
	+	===== 4. Importer la base dans votre nouveau blog =====
	+
	+	Dans l’interface d’administration de DotClear de votre nouveau blog rendez-vous sur l’onglet Outils, lien //Opérations MySql//, dans la partie //Restaurer une sauvegarde//, cliquez sur le bouton « Parcourir » et sélectionnez le fichier que vous venez de sauvegarder, puis cliquez sur le bouton « Restauration ». (Devinez où tout ceci est [[http://doc.dotclear.net/1.2/admin/install\|détaillé]] ?)
	+
	+	===== 5. Optimiser la base =====
	+
	+	Et voilu ! vos billets sont tous là. S’ils ne s’affichent pas tout de suite dans votre blogue il suffit de vider le cache de votre navigateur et/ou refaire la manip d’optimisation depuis l’interface d’administration de DotClear décrite au point 1 ci-dessus.
	+
	+	===== Une petite pause ? =====
	+	Vérifiez avant de poursuivre que votre nouvelle installation est correcte : naviguez dans vos billets, vérifiez que votre répertoire images/ est accessible en écriture et en lecture, bref assurez-vous que tout tourne rond avant de passer à la suite.
	+
	+	===== 6. Les autres fichiers =====
	+
	+	Vous aviez probablement procédé à quelques personnalisations. Pour les retrouver dans votre nouvel espace, il faudra les refaire et/ou transférer les fichiers modifiés. Si vous êtes un lecteur assidu de la présente doc, ce dont je ne doute pas une seule seconde, vous devez avoir, bien rangés dans un espace de votre disque dur les répertoires images/ - tools/plugin1/ (etc.) - themes/votre-theme/ - share/
	+
	+	Placez ces répertoires dans votre nouvel espace ; s’ils existent (comme le répertoire share/ par exemple), remplacez-les par les vôtres.
	+
	+	Vous aurez remarqué que tout ceci est finalement très proche de la procédure de [[http://doc.dotclear.net/1.2/admin/upgrade\|mise à jour]].
	+
	+	<note>
	+	*Si votre thème personnel utilisait les fichiers php du thème par défaut et que vous les aviez personnalisés directement dans le répertoire themes/default/, il est grand temps de corriger cette lamentable erreur : recopiez dans le répertoire de votre thème personnalisé les fichiers .php du thème par défaut de votre ancien blog.
	+	*Je ne connais pas tous les plugins et cette règle s’applique peut-être aussi pour d’autres mais le plugin Pages connexes (Related) nécessite que vous cliquiez à nouveau sur le lien //Régénérer// et/ou sélectionniez la rubrique dédiée dans son panneau d’administration ; quant au plugin Table des matières, vous enregistrerez à nouveau la configuration – même si vous n’y faites aucun changement – via son panneau d’administration.
	+	</note>

1.2:admin:plugins

Wed, 16 Oct 2013 09:56:41 +0200

1177162324		Version actuelle
Ligne 14:		Ligne 14:

	Vous pouvez depuis cette liste l'activer ou le désactiver.		Vous pouvez depuis cette liste l'activer ou le désactiver.
		+

	==== Installation manuelle ====		==== Installation manuelle ====
Ligne 19:		Ligne 20:
	Téléchargez l'archive du plugin sur votre disque dur (ce fichier porte l'extension ''.tar.gz'' ou ''.zip'').		Téléchargez l'archive du plugin sur votre disque dur (ce fichier porte l'extension ''.tar.gz'' ou ''.zip'').

-	Décompressez, puis transférez-le sur votre serveur dans le répertoire /dotclear/ecrire/tools/	+	Décompressez, puis transférez le répertoire au nom du plugin et son contenu sur votre serveur dans le répertoire /dotclear/ecrire/tools/

	Rendez-vous dans l'interface d'administration de votre blog, onglet Outils, lien Gestionnaire des plugins. Vérifiez que votre nouveau plugin figure maintenant dans la liste des plugins installés.		Rendez-vous dans l'interface d'administration de votre blog, onglet Outils, lien Gestionnaire des plugins. Vérifiez que votre nouveau plugin figure maintenant dans la liste des plugins installés.

1.2:admin:root-install

Wed, 16 Oct 2013 09:56:41 +0200

1177161154		Version actuelle
Ligne 1:		Ligne 1:
-	====== Faire fonctionner DotClear à la racine de son site ======	+	====== Faire fonctionner Dotclear à la racine de son site ======

-	Faire fonctionner DotClear à la racine de son site est assez simple. Il existe plusieurs cas de figure.	+	Faire fonctionner Dotclear à la racine de son site est assez simple. Il existe plusieurs cas de figure.

	===== Une installation dans un sous-répertoire avec url à la racine =====		===== Une installation dans un sous-répertoire avec url à la racine =====

-	Cette procédure est celle que nous recommandons en premier lieu, notamment parce qu'elle facilitera grandement les mises à jour ultérieures. Elle est décrite dans l'article [[http://petit.dotclear.net/pages/2005/11/16/94-un-dotclear-proprement-a-la-racine\|Un Dotclear proprement à la racine]] du Petit dotclear Illustré..	+	Cette procédure est celle que nous recommandons en premier lieu, notamment parce qu'elle facilitera grandement les mises à jour ultérieures. Elle est décrite dans l'article [[http://petit.dotclear.net/pages/2005/11/16/94-un-dotclear-proprement-a-la-racine\|Un Dotclear proprement à la racine]] du Petit Dotclear Illustré..


Ligne 11:		Ligne 11:
	===== Installation avec tout dans la racine =====		===== Installation avec tout dans la racine =====

-	Pour cette configuration, on suppose que vous avez installé tous les fichiers de DotClear directement à la racine de votre espace Web. Il n'y a donc pas de répertoire dotclear, le fichier index.php est accessible directement en allant sur votre site.	+	Pour cette configuration, on suppose que vous avez installé tous les fichiers de Dotclear directement à la racine de votre espace Web. Il n'y a donc pas de répertoire dotclear, le fichier index.php est accessible directement en allant sur votre site.

-	On suppose que DotClear est installé correctement. Par défaut, vos URL vont être fausses, il va falloir changer pas mal de choses dans votre configuration. Voici les options à changer et leurs valeurs correctes :	+	On suppose que Dotclear est installé correctement. Par défaut, vos URL vont être fausses, il va falloir changer pas mal de choses dans votre configuration. Voici les options à changer et leurs valeurs correctes :

	* URL vers le blogue : /		* URL vers le blogue : /
Ligne 87:		Ligne 87:
	===== Dernier recours =====		===== Dernier recours =====

-	Chez certains hébergeurs ne permettant pas les rewriterules mais n'ayant pas complètement interdit l'utilisation des .htaccess, il est possible de contourner le problème en configurant DotClear en Path Info et en entrant la ligne suivante dans le fichier .htaccess :	+	Chez certains hébergeurs ne permettant pas les rewriterules mais n'ayant pas complètement interdit l'utilisation des .htaccess, il est possible de contourner le problème en configurant Dotclear en Path Info et en entrant la ligne suivante dans le fichier .htaccess :

	<code>ErrorDocument 404 /index.php</code>		<code>ErrorDocument 404 /index.php</code>

1.2:admin:security

Wed, 16 Oct 2013 09:56:41 +0200

1173894887		Version actuelle
Ligne 3:		Ligne 3:
	===== Mot de passe et login =====		===== Mot de passe et login =====

-	Choisissez un mot de passe compliqué de plus de 6 caractères et changez le régulièrement	+	Choisissez un mot de passe compliqué de plus de 6 caractères et changez le régulièrement.
		+	:?: sans accents ni espaces ? --- //[[Anne Cavalier]] 2007/04/21 15:33//

	===== Le répertoire d'installation =====		===== Le répertoire d'installation =====

-	Vous n'avez généralement pas besoin du répertoire d'installation une fois que celle-ci est faite (ou une mise à jour). Éditez le fichier .htaccess se trouvant dans le répertoire install de votre weblogue et décommentez la ligne :	+	Vous n'avez généralement pas besoin du répertoire d'installation une fois que celle-ci est faite (ou une mise à jour). Éditez le fichier .htaccess se trouvant dans le répertoire install de votre weblogue et décommentez la ligne :

	<code>Deny From all</code>		<code>Deny From all</code>
Ligne 13:		Ligne 14:
	Vous pouvez également complètement supprimer ce répertoire.		Vous pouvez également complètement supprimer ce répertoire.

-	===== Le gestionnaire de fichiers =====
-
-	L'installation du gestionnaire de fichiers est une faille potentielle puisqu'elle donne accès à un administrateur aux fichier de votre weblogue, lui donnant la possibilité d'uploader un script PHP qui ira récupérer les fichiers protégés par le gestionnaire de fichiers. Si vous n'en avez pas besoin, ne l'installez pas.

	===== Thèmes et plugins =====		===== Thèmes et plugins =====

-	Les deux outils de gestion des thèmes et des plugins sont très commodes puisqu'ils permettent d'installer très facilement un thème et un plugin. Si vous n'avez pas besoin d'installer de nouveaux thèmes ou plugins, supprimez ces deux plugins ou interdisez l'accès en écriture aux répertoires ecrire/tools et themes/	+	Les deux outils de gestion des thèmes et des plugins sont très commodes puisqu'ils permettent d'installer très facilement un thème et un plugin mais si vous n'avez pas besoin d'installer de nouveaux thèmes ou plugins, supprimez ces deux plugins ou interdisez l'accès en écriture aux répertoires ecrire/tools et themes/

	===== Renommer le répertoire ecrire =====		===== Renommer le répertoire ecrire =====

-	Vous pouvez renommer le répertoire ecrire/ en quelque chose d'autre et ce n'est pas une mauvaise idée. Si vous le faites, vous devrez changer la valeur de la constante DC_ECRIRE dans le fichier inc/prepend.php et dans install/prepend.php.	+	Vous pouvez renommer le répertoire ecrire en quelque chose d'autre et ce n'est pas une mauvaise idée. Si vous le faites, vous devrez changer la valeur de la constante DC_ECRIRE dans le fichier inc/prepend.php et dans install/prepend.php.
		+
		+	<note warning>L'installation du plugin Gestionnaire de fichiers est une faille potentielle puisqu'elle donne accès à un administrateur aux fichier de votre weblogue, lui donnant la possibilité d'uploader un script PHP qui ira récupérer les fichiers protégés par le gestionnaire de fichiers. Si vous n'en avez pas besoin, ne l'installez pas.</note>

1.2:admin:themes

Wed, 16 Oct 2013 09:56:41 +0200

1172695259		Version actuelle
Ligne 1:		Ligne 1:
	====== Gestion des thèmes ======		====== Gestion des thèmes ======

-	===== Installer un thème =====	+	Cette partie est développée dans la section [[http://doc.dotclear.net/1.2/usage/themes\|Habillage du blog]]

-	On peut installer un thème par deux méthodes : automatiquement ou manuellement.
-
-	==== Installation automatique ====
-
-	Choisissez un thème et relevez son URL d'installation (cette URL porte l'extension .pkg.gz).
-
-	Dans l'interface d'administration de votre blog, choisissez l'onglet Outils puis le lien Gestionnaire des thèmes.
-
-	Dans le champ prévu à cet effet (Indiquez l'URL (http ou ftp) du fichier de thème :) copiez l'URL d'installation que vous avez relevée puis cliquez sur Installer. Le nouveau thème apparaît alors dans la liste.
-
-	Cliquez sur le lien Utiliser ce thème. Une petite étoile s'affiche à côté de son nom.
-
-	Votre thème est installé.
-
-	==== Installation manuelle ====
-
-	Choisissez un thème et téléchargez son archive sur votre disque dur (ce fichier porte l'extension .tar.gz ou .zip).
-
-	Décompressez, puis transférez-le sur votre serveur dans le répertoire /dotclear/themes/
-
-	Rendez-vous dans l'interface d'administration de votre blog, onglet Outils, lien Gestionnaire des thèmes. Le nouveau thème figure maintenant dans la liste des thèmes disponibles.
-
-	Cliquez sur le lien Utiliser ce thème. Une petite étoile s'affiche à côté de son nom.
-
-	Votre thème est installé.
-
-	===== Suppression d'un thème =====
-
-	Pour supprimer définitivement un thème, utilisez le lien Supprimer figurant à côté du lien Utiliser ce thème. En principe, cette opération fait également disparaître le dossier du thème. Si toutefois les droits chez votre hébergeur n'ont pas permis que ce processus se déroule complètement et que le dossier existe encore, vous pourrez le jeter via votre client ftp.

		+	FIXME on met cette partie ici ou on la laisse dans Usage ?
		+	--- //[[Anne Cavalier]] 2007/04/21 15:24//

1.2:admin:tools

Wed, 16 Oct 2013 09:56:41 +0200

1181208930		Version actuelle
Ligne 27:		Ligne 27:

	Un tutoriel pour l'utilisation de ce plugin est disponible dans le Petit Dotclear Illustré : [[http://petit.dotclear.net/pages/2006/03/21/103-convertir-son-blog-en-utf-8\|Convertir son blog en UTF-8]]. Sa lecture est chaudement recommandée avant toute conversion.		Un tutoriel pour l'utilisation de ce plugin est disponible dans le Petit Dotclear Illustré : [[http://petit.dotclear.net/pages/2006/03/21/103-convertir-son-blog-en-utf-8\|Convertir son blog en UTF-8]]. Sa lecture est chaudement recommandée avant toute conversion.
		+

	===== Gestionnaire de liens =====		===== Gestionnaire de liens =====
	//Interface Web pour configurer vos liens (blogroll).//		//Interface Web pour configurer vos liens (blogroll).//
		+
		+	Un blog fait des liens vers d'autres blogs ! Ce plugin vous permet de gérer votre liste de liens. Vous pouvez créer des catégories afin de les classer comme bon vous semble.

	===== Gestionnaire des plugins =====		===== Gestionnaire des plugins =====

1.2:admin:upgrade

Wed, 16 Oct 2013 09:56:41 +0200

1265450390		Version actuelle
Ligne 1:		Ligne 1:
-	hello NEW{{:wiki:dokuwiki-128.png\|}}	+	====== Mise à jour de Dotclear ======

	Mettre à jour Dotclear n'a rien de bien compliqué, c'est même très facile.		Mettre à jour Dotclear n'a rien de bien compliqué, c'est même très facile.

1.2:admin:users

Wed, 16 Oct 2013 09:56:41 +0200

1172832385		Version actuelle
Ligne 3:		Ligne 3:
	===== Rédacteurs =====		===== Rédacteurs =====

-	Par défaut, un rédacteur admin est créé sur votre blogue.	+	Le premier rédacteur de votre blog possède les droits d'administrateur. C'est celui que vous avez créé à l'installation.
-		+
-	Vous devez impérativement le renommer et changer son mot de passe pour des raisons évidentes de sécurité.	+

	Comme pour les catégories on ne peut supprimer un rédacteur que s'il n'a aucun billet à son actif.		Comme pour les catégories on ne peut supprimer un rédacteur que s'il n'a aucun billet à son actif.
Ligne 19:		Ligne 17:
	===== Préférences =====		===== Préférences =====

-	Les préférences sont accessibles à tous les utilisateurs. Elles permettent à chaque utilisateur de définir son mode de travail préféré avec DotClear et les informations qui seront affichées sur le blogue.	+	Les préférences sont accessibles à tous les utilisateurs. Elles permettent à chaque utilisateur de définir son mode de travail préféré avec DotClear et les informations qui seront affichées sur le blogue ([[..:/usage/user-preferences\|Voir les détails]].
-		+
-	On notera que par défaut le blogue affiche le pseudonyme de l'utilisateur. S'il n'en trouve pas, il utilisera le prénom suivi du nom.	+