Documentation de 99ko

Installer et configurer 99ko

Configuration recommandée

- PHP 5.6 ou +
- Librairie GD activée
- Mod_rewrite apache activé

Installation

- Téléchargez la dernière version de 99ko
- Dézippez l’archive
- Uploadez son contenu vers votre serveur
- Rendez-vous sur votre site avec votre navigateur
- L’installateur vous demande alors une adresse email et un mot de passe administrateur

Après l’installation, il est nécessaire de supprimer le fichier install.php de votre serveur. 

Modifier le thème par défaut de 99ko

La modification du thème par défaut est une opération simple à réaliser si vous avez des connaissances en intégration, mais il faut avant tout connaître quelques bonnes pratiques et l’existence de la classe show. 

Préparation

Avant de modifier le thème par défaut, il est important de le dupliquer et de ne pas travailler directement sur ses fichiers sources. Ceci, tout simplement pour éviter le risque de perdre votre travail lors d’une mise à jour de 99ko. 

- Dupliquez donc le thème default situé dans le répertoire theme et nommez-le comme bon vous semble
- Ouvrez le fichier infos.json du nouveau thème et modifiez les informations (nom du thème, version, auteur...)
- Activez le thème via le panel de configuration de l’administration.

Anatomie d’un thème

Les fichier ci-dessous doivent obligatoirement être présent. 

- 404.php : template affiché en cas d’erreur 404
- footer.php : pied de page
- header.php haut de page
- infos.json : fichier d’informations relatives au thème
- scripts.js : fichier contenant le code source javascript
- styles.css : fichier contenant le code source CSS
- functions.php : fichier optionnel pouvant contenir du code PHP

jQuery & Normalize.css

jQuery et Normalize.css sont automatiquement gérés par 99ko, il est donc inutile d’intégrer ses composants dans votre thème.

Attention au hooks !

Dans les différents fichier PHP du thème, vous rencontrerez des "Hooks". Un hook ne doit surtout pas être supprimé ou déplacé. Voici à quoi ressemble un hook : 

eval($core->callHook(‘frontHead’));

La classe PHP show

Cette classe PHP est composée de méthodes qui permettent d’afficher des informations diverses. 

- show::msg() : affiche un message
- show::linkTags() : utilisée pour le chargement des sources javascript
- show::scriptTags() : utilisée pour le chargement des sources CSS
- show::titleTag() : affiche le contenu de la meta title
- show::metaDescriptionTag() : affiche le contenu de la meta description
- show::mainTitle() : affiche le titre de page (cette méthode accepte un paramètre de format)
- show::siteName() : affiche le nom du site
- show::siteDescription() : affiche la description du site
- show::siteUrl() : affiche l’URL du site
- show::mainNavigation() : affiche le menu (cette méthode accepte un paramètre de format)
- show::theme() : affiche le thème courant (cette méthode accepte un paramètre de format)
- show::pluginId() : affiche le plugin courant
- show::currentUrl() : affiche l’URL courante
- show ::themeIcon() : affiche l’URL du favicon

Surcharge de la classe PHP show

Il est possible de surcharger les méthodes de la classe show en créant des fonctions portant le même nom dans le fichier functions.php de votre thème :

// exemple
function mainNavigation(){
// votre code ici...
}

Personnalisation des templates dans 99ko

Dans 99ko, un plugin dispose en principe d’un template, qu’il est possible de remplacer par un template modifié selon ses besoins. Une page statique peut elle même disposer de son propre template, ce qui est par exemple utile pour créer une page d’accueil différente des autres pages. 

Le plugin Page

Le plugin Page de 99ko permet d’affecter un template spécifique à une page statique. Ce template peut contenir du contenu non dynamique, mais peut aussi faire appel au contenu d’une ou plusieurs pages ou même d’un plugin. L’affectation d’un template à une page se fait via l’administration. Le template en question doit se trouver dans le dossier de votre thème.

Les autres plugins

Modifier le template d’un plugin est très simple : copiez le template public.php du plugin en question et collez-le dans le dossier de votre thème. Renommez-le afin qu’il porte le nom exact du plugin (exemple : news.php, si le plugin concerné est News). Vous pouvez à présent modifier le template dupliqué, car celui-ci est désormais prioritaire sur le template d’origine du plugin. Après avoir apporté vos modifications, il peut être nécessaire de vider le cache plugins via le gestionnaire de plugins de l’administration. 

Modifications du CSS des plugins

Pour apporter des modifications au CSS d’un plugin, il n’est pas recommandé d’agir sur la feuille de style du plugin, mais d’ajouter vos modifications sur la feuille de style de votre thème. En effet la feuille de style du thème étant dernière dans l’ordre de chargement, il est possible de surcharger ou d’écraser le CSS d’un plugin via ce fichier.

Depuis la version 5.0 c’est le thème qui prend en charge le CSS des plugins par défaut. Cependant les plugins tiers peuvent disposer de leur propre feuille de styles.

Liste des hooks dans 99ko

Le système de hooks permet aux plugins d’interagir avec 99ko et de modifier son comportement. Beaucoup de hooks sont présents dans le code source de 99ko, en voici la liste complète.

Thème

- theme/default/footer.php : footer
- theme/default/footer.php : endFooter
- theme/default/footer.php : endFrontBody
- theme/default/header.php : frontHead
- theme/default/header.php : endFrontHead

Admin

- admin/footer.php : endAdminBody
- admin/header.php : adminHead
- admin/header.php : endAdminHead
- admin/login.php : adminHead
- admin/login.php : endAdminHead
- admin/login.php : endAdminBody


FacebookTwitter