Utiliser la surcharge des fichiers.

1. Qu'est-ce que la surcharge des fichiers?

La surcharge est un principe simple qui permet de customiser vos sites basés sur les plugins génériques de CaMykS.

Cette méthode permet de conserver le dossier du CMS intact. De ce fait, vous pouvez continuer à profiter des mises à jour de CaMykS, et le partager entre plusieurs sites.

Le temps de développement est optimisé, on ne réécrit que les fichiers nécessaires pour le site web en cours de construction. Le temps gagné permet de se concentrer sur les plugins spécifiques qui requièrent bien plus d'attention.

Les compétences nécessaires pour la création d'un site "original" sont alors réduites à la simple connaissance du HTML, des CSS ainsi que de légères bases en script PHP. Un designer web peut alors créer un site web complet, dynamique et administré.

2. Les templates.

La surcharge sur les templates se fait sur le layout HTML principal, puis sur les styles appliqués. Elle permet de redimensionner la structure d'une page, de modifier l'espacement des cellules de contenu ou d'améliorer le template avec des images spécifiques. 

3. Les modules.

La modification des modules est certainement celle dont on peut le plus profiter. Des layouts aux images, toutes les customisations sont possibles ! Les utilisations les plus communes de cette réécriture sont l'insertion du titre de la page, de publicité bien placée ou encore d'illustration générique.

4. Les thèmes.

La surcharge sur les thèmes est périlleuse, si il est en effet possible de réécrire certains fichiers, la structure et l'aspect global du thème peuvent en souffrir. Ces modifications sont à effectuer avec précaution.

5. Les inputs.

Tout comme les thèmes, ces plugins n'ont pas vocation à être surchargés, même si cela reste possible.

6. Limites de la surcharge.

La customisation possède des limites. Actuellement, la surcharge n'est disponible que sur les plugins. Par exemple, il n'est pas possible de réécrire un layout HTML du moteur. La surcharge ne peut s'effectuer que sur les éléments graphiques : les layouts, les feuilles de styles et les images. Pour conserver la statibilité maximum des sites, les scripts JavaScripts ou encore les librairies PHP ne sont pas surchargeables. Si vous avez le besoin de modifier un script ou une librairie, vous devez envisager de développer un nouveau plugin.

7. Comment utiliser la surcharge.

Il est très simple de profiter de la surcharge, il suffit de copier le fichier désiré à partir de la structure des plugins de CaMykS dans les plugins de votre site. Par exemple, pour réécrire les styles du template WebPage, copiez le fichier :

/www/camyks/plugin/template/WebPage/style.css

dans le dossier :

/www/mon_site/plugin/template/WebPage/style.css

ou www est votre racine web et mon_site est le dossier de votre site.

CaMykS se charge ensuite de tout, les nouveaux styles seront appliqués au template WebPage utilisé dans vos pages.

Pour insérer une image dans le template, ajoutez votre image dans le dossier, par exemple :

/www/mon_site/plugin/template/WebPage/img/header.jpg

Pour afficher votre en-tête, vous avez ensuite 2 solutions.

Dans le layout, il suffit, dans celui-ci, d'ajouter la requête vers l'image :

<div id="header">
<img src="<?=$this->get_fileURL('img/header.jpg');?>" alt="" border="0" />
</div>

Si vous préférez placer l'image en fond d'un objet HTML, vous pouvez utiliser les CSS :

#header{background:url(img/header.jpg) no-repeat;}

La feuille de style étant dans le même sous-dossier que l'image, elle est automatiquement trouvée.

8. Conclusion.

Couplée à un thème proprement réalisé, cette solution très simple permet de réaliser des sites intégrant les plugins génériques tout en conservant une identité propre. Un site complet offrant une pointe d'originalité peut être développé rapidement.