Écrire un CMS en PHP

Structure du contenu

Créez site19 en copiant site18.

/cms
1. ...
2. site18
3. site19

Dans ce chapitre, nous allons programmer la gestion du contenu du site et son affichage.

Pour tester le résultat en ligne, entrez http://www.frasq.org/cms/site19/fr/noeud/1 dans la barre d'adresse de votre navigateur. Le site affiche le contenu du nœud 1 en français. Entrez http://www.frasq.org/cms/site19/en/node/1 pour afficher sa traduction en anglais.

Un nœud a un titre, un nom, un extrait et un nuage de mots qui lui sont associés. Un nœud a un contenu, en l'occurrence, un texte en HTML.

Affichez le code source de la page. Remarquez que la balise <meta name="description" /> contient l'extrait du nœud et que la balise <meta name="keywords" /> contient le nuage de mots. Ces informations sont normalement exploitées par les moteurs de recherche. Le nom d'un nœud pourra permettre de le désigner dans une URL. Son titre est généralement affiché en début de page.

Démarrez le processeur de commandes de MySQL et entrez dans la BD du site :

$ mysql -u root -p
mysql> use frasqdb2;

NOTE : Utilisez phpMyAdmin pour plus de confort.

Ajoutez la table node puis la table node_locale à la BD du site :

CREATE TABLE node (
node_id INT( 10 ) UNSIGNED NOT NULL AUTO_INCREMENT ,
user_id INT( 10 ) UNSIGNED NOT NULL ,
created datetime NOT NULL ,
modified datetime NOT NULL ,
PRIMARY KEY ( node_id )
) ENGINE = MYISAM DEFAULT CHARSET = utf8;

Un node contient les propriétés d'un nœud communes à toutes les langues : son identifiant, l'identifiant de l'utilisateur qui l'a modifié pour la dernière fois, ses dates de création et de modification. La clé primaire d'un node est son identifiant.

CREATE TABLE node_locale (
node_id INT( 10 ) UNSIGNED NOT NULL AUTO_INCREMENT ,
locale enum( 'fr', 'en' ) NOT NULL DEFAULT 'fr',
name VARCHAR( 100 ) NOT NULL ,
title VARCHAR( 100 ) NOT NULL ,
abstract text,
cloud text,
PRIMARY KEY ( node_id , locale )
) ENGINE = MYISAM DEFAULT CHARSET = utf8;

Un node_locale contient les propriétés d'un nœud qui dépendent de la langue : la désignation de la langue du contenu, le nom du nœud, son titre, l'extrait et la liste de mots associés au nœud. L'identifiant d'un node_locale correspond à l'identifiant d'un node. Les désignations des langues doivent correspondre aux langues listées par le paramètre de configuration $supported_languages défini dans le fichier includes/config.inc. La clé primaire d'un node_locale est son identifiant et la désignation de la langue de son contenu.

CREATE TABLE content_text (
content_id INT( 10 ) UNSIGNED NOT NULL AUTO_INCREMENT ,
locale enum( 'fr', 'en' ) NOT NULL DEFAULT 'fr',
text text,
PRIMARY KEY ( content_id , locale )
) ENGINE = MYISAM DEFAULT CHARSET = utf8;

Un content_text contient un contenu de type text dans une langue donnée, en général du HTML. La clé primaire d'un content_text est son identifiant et la désignation de la langue de son contenu.

Le lien entre un nœud et son contenu est fait par la table node_content :

CREATE TABLE node_content (
node_id INT( 10 ) UNSIGNED NOT NULL ,
content_id INT( 10 ) UNSIGNED NOT NULL ,
content_type enum( 'text' ) CHARACTER SET ascii NOT NULL DEFAULT 'text',
`number` INT( 3 ) UNSIGNED NOT NULL ,
PRIMARY KEY ( node_id , content_id , content_type )
) ENGINE = MYISAM DEFAULT CHARSET = utf8;

Un node_content liste et ordonne les contenus d'un nœud. L'identifiant d'un node_id correspond à l'identifiant d'un node. content_id associé à content_type correspond à l'identifiant d'un contenu dans content_text. La clé primaire d'un node_content est l'identifiant d'un nœud, l'identifiant d'un contenu et son type.

Créez un premier nœud :

INSERT INTO node (node_id, user_id, created, modified) VALUES
(1, 1, NOW(), NOW());

Le nœud 1 est créé par l'utilisateur 1, l'administrateur du site. Vérifiez dans la table user.

Ajoutez ses propriétés en français :

INSERT INTO node_locale (node_id, locale, name, title, abstract, cloud) VALUES
(1, 'fr', 'informations-legales', 'Informations légales', 'Responsabilité de l''auteur - Droits.', 'copyright responsabilité auteur droits diffusion');

Ajoutez la version en anglais :

INSERT INTO node_locale (node_id, locale, name, title, abstract, cloud) VALUES
(1, 'en', 'legal-information', 'Legal information', 'Author''s liability - Rights.', 'copyright liability author rights distribution');

Ajoutez un contenu en français :

INSERT INTO content_text (content_id, locale, text) VALUES
(1, 'fr', '<p>Les informations, les techniques et les logiciels ("CONTENU")\r\nfournis par ce site ont un but purement éducatif\r\net ne doivent pas être interprétés comme un engagement par leur auteur ("AUTEUR").</p>\r\n<p>Le CONTENU est fourni "EN L''ÉTAT" sans garantie d''aucune sorte, expresse ou implicite,\r\ny compris, mais sans limitation, les garanties de qualité marchande,\r\nd''adéquation à un usage particulier et de non-violation des droits de tierces parties.\r\nL''AUTEUR ne saurait en aucun cas être tenu responsable de toute réclamation\r\nou dommage indirect ou consécutif ou de tout autre dommage\r\nlié à la perte d''utilisation, de données ou de bénéfices,\r\nque ce soit dans le cadre d''un contrat, d''une négligence ou d''une autre action préjudiciable,\r\ndus ou liés à l''utilisation ou aux performances du CONTENU.</p>');

Ajoutez sa traduction en anglais :

INSERT INTO content_text (content_id, locale, text) VALUES
(1, 'en', '<p>The information, the techniques and the software ("CONTENT")\r\nprovided by this web site are for educational purposes only\r\nand should not be construed as a commitment by their author ("AUTHOR").</p>\r\n<p>The CONTENT is provided "AS IS", without warranty of any kind, express or implied,\r\nincluding but not limited to the warranties of merchantability,\r\nfitness for a particular purpose and noninfringment of third party rights.\r\nIn no event shall the AUTHOR be liable for any claim,\r\nor any special indirect or consequential damages,\r\nor any damages whatsoever resulting from loss of use, data or profits,\r\nwhether in an action of contract, negligence or other tortious action,\r\narising out of or in connection with the use or performance of the CONTENT.</p>');

Remarquez que les identifiants des deux versions sont identiques mais que la langue diffère.

Créez l'association entre le nœud et son contenu :

INSERT INTO node_content (node_id, content_id, content_type, `number`) VALUES
('1', '1', 'text', '1');

Associe le nœud 1 au contenu 1 de type texte et le place en position 1.

frasqdb2.sql.zip

Essayez quelques requêtes sur la BD :

SELECT node_id FROM node WHERE node_id=1 LIMIT 1;

Vérifie que le nœud 1 a bien été créé.

SELECT nloc.name AS node_name, nloc.title AS node_title, nloc.abstract AS node_abstract, nloc.cloud AS node_cloud, n.user_id AS node_user, n.created AS node_created, n.modified AS node_modified
FROM node n
JOIN node_locale nloc ON nloc.node_id=n.node_id AND nloc.locale='fr'
WHERE n.node_id=1
LIMIT 1;

Retourne tous les attributs de la version en français du nœud 1.

SELECT nc.content_id AS content_id, nc.content_type AS content_type, `nc.number` AS content_number, ct.text AS content_text
FROM node_content nc
JOIN content_text ct ON nc.content_type='text' AND ct.content_id=nc.content_id AND ct.locale='fr'
WHERE nc.node_id=1
ORDER BY `nc.number`;

Retourne le contenu en français du nœud 1.

Ajoutez le fichier node.inc dans le dossier models avec le contenu suivant :

function node_id($node) {
if (!is_numeric($node)) {
return false;
}
$tabnode=db_prefix_table('node');
$sql="SELECT node_id FROM $tabnode WHERE node_id=$node LIMIT 1";
$r = db_query($sql);
return $r ? $r[0]['node_id'] : false;
}

node_id retourne l'identifiant du nœud dont l'identifiant est $node, ou false si le nœud $node n'existe pas.

function node_get($lang, $node_id) {
$sqllang=db_sql_arg($lang, false);
$tabnode=db_prefix_table('node');
$tabnodelocale=db_prefix_table('node_locale');
$sql="SELECT nloc.name AS node_name, nloc.title AS node_title, nloc.abstract AS node_abstract, nloc.cloud AS node_cloud, n.user_id AS node_user, UNIX_TIMESTAMP(n.created) AS node_created, UNIX_TIMESTAMP(n.modified) AS node_modified FROM $tabnode n JOIN $tabnodelocale nloc ON nloc.node_id=n.node_id AND nloc.locale=$sqllang WHERE n.node_id=$node_id LIMIT 1";
$r = db_query($sql);
return $r ? $r[0] : false;
}

node_get retourne tous les attributs pour la langue $lang du nœud dont l'identifiant est $node_id, ou false en cas d'erreur. Remarquez que les champs node_created et node_modified sont convertis en temps Unix.

function node_get_contents($lang, $node_id) {
$sqllang=db_sql_arg($lang, false);
$tabnodecontent=db_prefix_table('node_content');
$tabcontenttext=db_prefix_table('content_text');
$sql="SELECT nc.content_id AS content_id, nc.content_type AS content_type, nc.number AS content_number, ct.text AS content_text FROM $tabnodecontent nc JOIN $tabcontenttext ct ON nc.content_type='text' AND ct.content_id=nc.content_id AND ct.locale=$sqllang WHERE nc.node_id=$node_id ORDER BY nc.number";
$r = db_query($sql);
return $r;
}

node_get_contents retourne le contenu du nœud $node_id pour la langue $lang, ou false en cas d'erreur.

Créez l'action node en ajoutant le fichier node.php dans le dossier actions avec le contenu suivant :

/cms/site19
1. actions
  1. node.php

node.php

require_once 'models/node.inc';
function node($lang, $arglist=false) {
$node=false;
if (is_array($arglist)) {
if (isset($arglist[0])) {
$node=$arglist[0];
}
}
if (!$node) {
return run('error/notfound', $lang);
}
$node_id = node_id($node);
if (!$node_id) {
return run('error/notfound', $lang);
}
$r = node_get($lang, $node_id);
if (!$r) {
return run('error/notfound', $lang);
}
extract($r); /* node_name node_title node_abstract node_cloud */
head('title', $node_id);
head('description', $node_abstract);
head('keywords', $node_cloud);
head('robots', 'noindex, nofollow');
$banner = build('banner', $lang);
$node_contents = build('nodecontent', $lang, $node_id);
$content = view('node', $lang, compact('node_name', 'node_title', 'node_abstract', 'node_cloud', 'node_contents'));
$output = layout('standard', compact('banner', 'content'));
return $output;
}

L'action node retourne une page affichant le contenu d'un nœud construit par le bloc nodecontent. node prend un argument, un numéro de nœud. Si le numéro de nœud est manquant ou invalide, node renvoie une erreur HTTP 404 Not Found.

Pour donner accès à l'action node, ajoutez un alias par langue dans le fichier includes/aliases.inc :

aliases.inc

'noeud' => 'node',

'node' => 'node',

Ajoutez la vue d'un nœud dans les dossiers views/fr pour la version en français et views/en pour la version en anglais :

/cms/site19
1. views
  1. fr
    1. node.phtml
  2. en
    1. node.phtml

node_fr.phtml

<h3><?php echo htmlspecialchars($node_title, ENT_COMPAT, 'UTF-8'); ?></h3>
<?php if ($node_abstract): ?>
<h5>Extrait</h5>
<p><?php echo htmlspecialchars($node_abstract, ENT_COMPAT, 'UTF-8'); ?></p>
<?php endif; ?>
<?php if ($node_cloud): ?>
<h6>Nuage</h6>
<p class="smaller"><?php echo htmlspecialchars($node_cloud, ENT_COMPAT, 'UTF-8'); ?></p>
<?php endif; ?>
<?php if ($node_contents): ?>
<h4>Contenu</h4>
<?php echo $node_contents; ?>
<?php endif; ?>

node_en.phtml

<h3><?php echo htmlspecialchars($node_title, ENT_COMPAT, 'UTF-8'); ?></h3>
<?php if ($node_abstract): ?>
<h5>Abstract</h5>
<p><?php echo htmlspecialchars($node_abstract, ENT_COMPAT, 'UTF-8'); ?></p>
<?php endif; ?>
<?php if ($node_cloud): ?>
<h6>Cloud</h6>
<p class="smaller"><?php echo htmlspecialchars($node_cloud, ENT_COMPAT, 'UTF-8'); ?></p>
<?php endif; ?>
<?php if ($node_contents): ?>
<h4>Contents</h4>
<?php echo $node_contents; ?>
<?php endif; ?>

Ajoutez la fonction nodecontent qui retourne le contenu d'un nœud :

/cms/site19
1. blocks
  1. nodecontent.php

nodecontent.php

require_once 'models/node.inc';
function nodecontent($lang, $node_id) {
$contents = array();
$r = node_get_contents($lang, $node_id);
if ($r) {
foreach ($r as $c) { /* content_id content_number content_type content_text */
$type=$c['content_type'];
switch($type) {
case 'text':
$s=$c['content_text'];
if (!empty($s)) {
$text = $s;
$contents[] = compact('type', 'text');
}
break;
default:
break;
}
}
}
$output = view('nodecontent', false, compact('contents'));
return $output;
}

Comme la vue du bloc ne dépend pas de la langue, ajoutez-la directement dans le dossier views :

/cms/site19
1. views
  1. nodecontent.phtml

nodecontent.phtml

<?php
foreach ($contents as $c) {
switch($c['type']) {
case 'text':
$text_content = $c['text'];
echo $text_content, PHP_EOL;
break;
default:
break;
}
}
?>

Entrez http://localhost/cms/site19/fr/noeud/1 puis http://localhost/cms/site19/en/node/1 dans la barre d'adresse de votre navigateur.

Ajoutez un second contenu à la page :

INSERT INTO content_text (content_id, locale, text) VALUES
(2, 'fr', '<p><i>13 mai 2010</i></p>\r\n<p><b>frasq.org</b></p>'),
(2, 'en', '<p><i>May 13, 2010</i></p>\r\n<p><b>frasq.org</b></p>');

INSERT INTO node_content (node_id, content_id, content_type, `number`) VALUES
('1', '2', 'text', '2');

Rechargez les pages Informations légales et Legal information.

site19.zip

frasq.org

Structure du contenu

Commentaires

Votre commentaire :