""
Documentation daCode : Guide du webmestre de daCode
Chapitre 5. Personnalisation

 

Partager ses habillages

 

Création d'une archive

Une fois qu'on a mis au point son nouvel habillage, on peut vouloir en faire profiter les autres. La méthode est très simple : il suffit de définir dans le fichier de configuration src/phplib/config.php3 la variable $this->create_tar_dir contenant le nom d'un répertoire dans lequel PHP peut écrire, d'utiliser son compte d'administrateur sur sa version de daCode, et de cliquer sur les « Habillages » de la boîte d'administration. La page suivante montre la liste des habillages actuellement installés, et cliquer sur un lien produit une archive.

Par exemple, si $this->create_tar_dir vaut "/tmp/" et que l'habillage s'appelle « print », le fichier /tmp/daCode-print-0.1.tar.gz est créé. Le numéro de version est pris dans le fichier src/phplib/themes/print/VERSION comme expliqué ci-dessous.

 

Contenu de l'archive

Voici par exemple quel pourrait être le contenu de l'archive de l'habillage « print » :


    daCode-print-0.1.1
      |-- html
      |   |-- images
      |   |   |-- image1.png
      |   |   |-- image2.png
      |   |   |-- logoprint.png
      |   |   |-- section
      |   |   |   |-- dacode.png
      |   |   |   |-- topic1.png
      |   |   |   `-- topic2.png
      |   |   `-- text-plain.png
      |   `-- print.css
      `-- templates
      |-- VERSION
      |-- admin.tmpl
      |-- basic.tmpl
      |-- board.tmpl
      |-- doc.tmpl
      |-- html.php3
      |-- myposts.tmpl
      |-- news.tmpl
      |-- newsindex.tmpl
      |-- newssection.tmpl
      |-- poll.tmpl
      |-- search.tmpl
      |-- submit.tmpl
      |-- submitcom.tmpl
      |-- submitpoll.tmpl
      |-- thread.tmpl
      |-- users.tmpl
      `-- webcam.tmpl
      
      
   


Le fichier daCode-print-0.1/templates/VERSION est composé des trois lignes suivantes:


    1
      print
      0.1
      
   


Il s'agit tout simplement du nom de l'habillage, et du numéro de version, la première ligne indiquant le numéro du format utilisé (actuellement seule la valeur 1 est reconnue par daCode). Ce fichier est nécessaire pour créer ou extraire les archives avec l'interface de daCode.

Comme on le voit, il est facile de créer cette archive à la main, sans utiliser daCode. Il faut mettre les templates dans un sous-répertoire templates/, y ajouter un fichier VERSION contenant le nom et le numéro de version de l'habillage, et mettre sous html/ les fichiers qui sont sous src/htdocs/themes/print/.

 

Proposer un habillage à un serveur daCode

Cette partie n'est pas encore écrite dans daCode, il suffit d'ajouter une page permettant à l'internaute d'envoyer son archive. Cette archive sera mise dans le répertoire défini dans la variable $this->upload_tar_dir du fichier de configuration.

Vous pouvez également, si vous le souhaitez, soumettre directement ce habillage au site officiel de daCode

 

Installer un nouvel habillage

Quand un internaute propose un habillage, ou quand on met une archive dans le répertoire défini dans la variable $this->upload_tar_dir du fichier de configuration, l'administrateur du serveur daCode peut installer ce nouvel habillage. Pour cela, il doit cliquer sur le même lien « Habillages » de la boîte d'administration. La page suivante montre la liste des habillages actuellement installés, ainsi que les archives prêtes à installer. En cliquant sur une de ces archives, une nouvelle page apparaît qui donne la liste des fichiers contenus dans l'archive, ainsi que l'endroit où ils seront placés. On peut visualiser le contenu des fichiers en cliquant sur le nom du fichier. Après avoir vérifié le contenu des fichiers, l'administrateur peut choisir d'installer cet habillage en cliquant sur « installer », et/ou d'effacer l'archive.

Cette procédure automatique installe les fichiers au bon endroit, même si les répertoires htdocs/ ou phplib/ ont été renommés ou déplacés.

Il faut que PHP ait le droit d'écrire dans les répertoires src/htdocs/themes/ et src/phplib/themes/ pour extraire les fichiers. Afin de ne pas mettre ces répertoires en écriture pour PHP, il est préférable de donner dans la variable $this->theme_subdir le nom d'un sous-répertoire, qui, lui, sera le seul à être accessible en écriture par PHP. Ainsi, si $this->theme_subdir="contrib/", l'administrateur doit créer les répertoires src/htdocs/themes/contrib/ et src/phplib/themes/contrib/ et les mettre en écriture pour PHP.

L'habillage « print » sera alors désarchivé dans les répertoires src/htdocs/themes/contrib/print/ et src/phplib/themes/contrib/print/

Enfin, pour que cet habillage puisse être utilisé, il faut l'ajouter dans la variable $this->listofthemes du fichier de configuration, comme nous l'avons vu plus haut.