Objectifs
L’objectif de ce tutoriel est de vous faire développer une première page avec Copix, de façon à introduire les différents concepts de l’outil.
Nous allons ici répondre à l'url index.php/default/hello/you (qui peut également revêtir la forme index.php?group=hello&action=you).
Note: pour en savoir plus sur les URL Copix, consultez la page "comprendre la forme des URL".
Introduction
Dans Copix, une "URL/page HTML" correspond à une action. Ces actions sont implémentées dans des ActionGroup. Ces ActionGroup dérivent tous de CopixActionGroup.
Dans Copix, vous allez toujours développer dans des modules. Pour ce tutoriel, nous allons créer des éléments dans le module default (situé dans project/module/public/stable/standard/default)
Notre première page
Créez le fichier project/module/public/stable/standard/default/actiongroups/hello.actiongroup.php avec le contenu suivant :
<?php
/**
* Page d’accueil et fonctionnalité standard.
* Cet objet peut gérer en standard les urls de la forme index.php/moduleConcerné/hello/xxxx
*/
class ActionGroupHello extends CopixActionGroup {
/**
* Notre premier exemple
* Cette dernière implémente en standard l'url index.php/moduleConcerné/hello/you
*/
function processYou () {
}
}
?>
Implémentation de l'action
Nous souhaitons ainsi afficher une page avec dedans "hello you".
function processYou () {
$ppo = new CopixPPO ();//création de l'objet de données
$ppo->name = 'you'; //assignation d'une donnée
return _arPPO ($ppo, 'hello.tpl');//demande d'affichage des données
}
Copix utilise un modèle MVC (Modèle Vue Controller).
Ici, nous allons donc renseigner les variables du modèle dans la variable "$ppo" (PPO comme Plain PHP Object) qui est un simple objet permettant de véhiculer les données.
Nous attribuons à la variable $ppo->name la valeur "you".
Ensuite, nous indiquons que nous souhaitons afficher les données de la variable $ppo dans le template hello.tpl
Création du template
Créez le fichier project/modules/public/stable/standard/default/templates/hello.tpl avec le contenu suivant :
<p>Hello {$ppo->name}</p>
En standard, Copix utilise Smarty comme moteur de templates. Si vous le souhaitez, vous pouvez écrire vos template directement en PHP. Dans ce cas, il faudra utiliser l'extension ".php" pour ces derniers, et le code aurait été de la forme :