declarer_tables_objets_surnoms

Toujours fonctionnel mais désormais obsolète : il faut utiliser le pipeline declarer_tables_objets_sql.

Il permet d’indiquer la relation entre le type d’objet et sa correspondance SQL. Par défaut, un ’s’ de pluriel est ajouté (l’objet ’article’ donne une table SQL ’articles’). Le pipeline reçoit un tableau des correspondances de SPIP.

Appel du pipeline :

$surnoms = pipeline('declarer_tables_objets_surnoms',
	array(
		'article' => 'articles',
		'auteur' => 'auteurs',
		//...
	));

Ces correspondances permettent aux fonctions table_objet() et objet_type() de retrouver l’un et l’autre :

// type...
$type = objet_type('spip_articles'); // article
$type = objet_type('articles'); // article
// table...
$objet = table_objet('article'); // articles
$table = table_objet_sql('article'); // spip_articles
// id...
$_id_objet = id_table_objet('articles'); // id_article
$_id_objet = id_table_objet('spip_articles'); // id_article
$_id_objet = id_table_objet('article'); // id_article

Exemple

Le plugin « jeux » déclare sa relation de la sorte :

function jeux_declarer_tables_objets_surnoms($surnoms) {
	$surnoms['jeu'] = 'jeux';
	return $surnoms;
}

Auteur Matthieu Marcillaud Publié le : Mis à jour : 12/03/23

Traductions : English, français