SPIP

quete.php

Fonctions d'appel aux serveurs SQL presentes dans le code compile

NB : à l'exception des fonctions pour les balises dynamiques

Functions

quete_virtuel() : array<string|int, mixed>|bool|null: Retourne l'URL de redirection d'un article virtuel, seulement si il est publié
quete_parent_lang() : array<string|int, mixed>: Retourne le couple `parent,lang` pour toute table
quete_parent() : int: Retourne le parent d'une rubrique
quete_rubrique() : int: Retourne la rubrique d'un article
quete_profondeur() : int: Retourne la profondeur d'une rubrique
quete_condition_postdates() : string: Retourne la condition sur la date lorsqu'il y a des post-dates
quete_condition_statut() : array<string|int, mixed>|string: Calculer la condition pour filtrer les status,
quete_fichier() : array<string|int, mixed>|bool|null: Retourne le fichier d'un document
quete_document() : array<string|int, mixed>|bool: Toute les infos sur un document
quete_meta() : array<string|int, mixed>|bool|null: Récuperer une meta sur un site (spip) distant (en local il y a plus simple)
quete_logo() : array<string|int, mixed>|string: Retourne le logo d'un objet, éventuellement par héritage
quete_logo_objet() : bool|array<string|int, mixed>: Chercher le logo d'un contenu précis
quete_logo_file() : bool|string: Retourne le logo d’un fichier (document spip) sinon la vignette du type du fichier
quete_logo_document() : string: Trouver l'image logo d'un document
quete_html_logo() : string: Recuperer le HTML du logo d'apres ses infos
document_spip_externe() : string|false: Retourne le chemin d’un document lorsque le connect est précisé
vignette_logo_document() : string: Retourne la vignette explicitement attachee a un document le resutat est un fichier local existant, ou une URL ou vide si pas de vignette
calcul_exposer() : bool|string: Calcul pour savoir si un objet est expose dans le contexte fournit par $reference
quete_debut_pagination() : int: Trouver le numero de page d'une pagination indirecte lorsque debut_xxx=@123 on cherche la page qui contient l'item dont la cle primaire vaut 123
is_whereable() : bool: Retourne true si ce where doit être appliqué, dans le cas des critères avec ? tel que `{id_article ?}`

quete_virtuel()

Retourne l'URL de redirection d'un article virtuel, seulement si il est publié


    
                    quete_virtuel(int $id_article, string $connect) : array<string|int, mixed>|bool|null

Parameters

$id_article : int
$connect : string

Return values

array<string|int, mixed>|bool|null

quete_parent_lang()

Retourne le couple `parent,lang` pour toute table


    
                    quete_parent_lang(string $table, int $id[, string $connect = '' ]) : array<string|int, mixed>

En pratique id_rubrique si présent (ou id_parent pour table rubriques) et champ lang si présent

Parameters

$table : string
$id : int
$connect : string = ''

Return values

array<string|int, mixed>

quete_parent()

Retourne le parent d'une rubrique


    
                    quete_parent(int $id_rubrique[, string $connect = '' ]) : int

Repose sur la fonction quete_parent_lang pour la mutualisation +mise en cache SQL des requêtes

Parameters

$id_rubrique : int
$connect : string = ''

Return values

int

quete_rubrique()

Retourne la rubrique d'un article


    
                    quete_rubrique(int $id_article, string $serveur) : int

Repose sur la fonction quete_parent_lang pour la mutualisation +mise en cache SQL des requêtes

Parameters

$id_article : int
$serveur : string

Return values

int

quete_profondeur()

Retourne la profondeur d'une rubrique


    
                    quete_profondeur(int $id[, string $connect = '' ]) : int

Parameters

$id : int
$connect : string = ''

Return values

int

quete_condition_postdates()

Retourne la condition sur la date lorsqu'il y a des post-dates


    
                    quete_condition_postdates(string $champ_date[, string $serveur = '' ][, bool $ignore_previsu = false ]) : string

Parameters

$champ_date : string: Nom de la colonne de date dans la table SQL
$serveur : string = ''
$ignore_previsu : bool = false: true pour forcer le test même en prévisu

Return values

string —

Morceau de la requête SQL testant la date

quete_condition_statut()

Calculer la condition pour filtrer les status,


    
                    quete_condition_statut(string $mstatut, string $previsu, string $publie[, string $serveur = '' ][, bool $ignore_previsu = false ]) : array<string|int, mixed>|string

Parameters

$mstatut : string: Le champ de la table sur lequel porte la condition
$previsu : string: Mode previsu : statut ou liste des statuts séparés par une virgule
$publie : string: Mode publie : statut ou liste des statuts séparés par une virgule
$serveur : string = '': Serveur de BDD
$ignore_previsu : bool = false: true pour forcer le test même en prévisu

Return values

array<string|int, mixed>|string

quete_fichier()

Retourne le fichier d'un document


    
                    quete_fichier(int $id_document[, string $serveur = '' ]) : array<string|int, mixed>|bool|null

Parameters

$id_document : int
$serveur : string = ''

Return values

array<string|int, mixed>|bool|null

quete_document()

Toute les infos sur un document


    
                    quete_document(int $id_document[, string $serveur = '' ]) : array<string|int, mixed>|bool

Parameters

$id_document : int
$serveur : string = ''

Return values

array<string|int, mixed>|bool

quete_meta()

Récuperer une meta sur un site (spip) distant (en local il y a plus simple)


    
                    quete_meta(string $nom, string $serveur) : array<string|int, mixed>|bool|null

Parameters

$nom : string: Nom de la méta
$serveur : string: Connecteur

Return values

array<string|int, mixed>|bool|null

quete_logo()

Retourne le logo d'un objet, éventuellement par héritage


    
                    quete_logo(string $cle_objet, string $onoff, int $id, int $id_rubrique[, mixed $flag = false ]) : array<string|int, mixed>|string

Si flag != false, retourne le chemin du fichier, sinon retourne un tableau de 3 elements : le chemin du fichier, celui du logo de survol, l'attribut style=w/h.

Parameters

$cle_objet : string: Nom de la clé de l'objet dont on veut chercher le logo.
$onoff : string: Sélectionne quel(s) logo(s) : "on" pour le logo normal, "off" pour le logo de survol, ou "ON" pour l'ensemble.
$id : int: Identifiant de l'objet dont on veut chercher le logo.
$id_rubrique : int: Identifiant de la rubrique parente si l'on veut aller chercher son logo dans le cas où l'objet demandé n'en a pas.
$flag : mixed = false

Return values

array<string|int, mixed>|string —

Retourne soit un tableau, soit le chemin du fichier.

quete_logo_objet()

Chercher le logo d'un contenu précis


    
                    quete_logo_objet(int $id_objet, string $objet, string $mode) : bool|array<string|int, mixed>

Parameters

$id_objet : int: Idenfiant de l'objet dont on cherche le logo
$objet : string: Type de l'objet dont on cherche le logo
$mode : string: "on" ou "off" suivant le logo normal ou survol

Return values

bool|array<string|int, mixed>

quete_logo_file()

Retourne le logo d’un fichier (document spip) sinon la vignette du type du fichier


    
                    quete_logo_file(array<string|int, mixed> $row[, string $connect = null ]) : bool|string

Fonction appeleé par la balise #LOGO_DOCUMENT

Parameters

$row : array<string|int, mixed>
$connect : string = null

Return values

bool|string

quete_logo_document()

Trouver l'image logo d'un document


    
                    quete_logo_document(array<string|int, mixed> $row,  $lien,  $align,  $mode_logo,  $x,  $y[, string $connect = '' ]) : string

Parameters

$row : array<string|int, mixed>: description du document, issue de la base
$lien :: url de lien
$align :: alignement left/right
$mode_logo :: mode du logo : '' => automatique (vignette sinon apercu sinon icone) icone => icone du type du fichier apercu => apercu de l'image exclusivement, meme si une vignette existe vignette => vignette exclusivement, ou rien si elle n'existe pas
$x :: largeur maxi
$y :: hauteur maxi
$connect : string = '': serveur

Return values

string

quete_html_logo()

Recuperer le HTML du logo d'apres ses infos


    
                    quete_html_logo(array<string|int, mixed> $logo, string $align, string $lien) : string

Parameters

$logo : array<string|int, mixed>
$align : string
$lien : string

Return values

string

document_spip_externe()

Retourne le chemin d’un document lorsque le connect est précisé


    
                    document_spip_externe(string $fichier, string $connect) : string|false

Sur un connecteur distant, voir si on connait l’adresse du site (spip distant) et l’utiliser le cas échéant.

Parameters

$fichier : string: Chemin
$connect : string: Nom du connecteur

Return values

string|false

vignette_logo_document()

Retourne la vignette explicitement attachee a un document le resutat est un fichier local existant, ou une URL ou vide si pas de vignette


    
                    vignette_logo_document(array<string|int, mixed> $row[, string $connect = '' ]) : string

Parameters

$row : array<string|int, mixed>
$connect : string = ''

Return values

string

calcul_exposer()

Calcul pour savoir si un objet est expose dans le contexte fournit par $reference


    
                    calcul_exposer(int $id, string $prim, array<string|int, mixed> $reference, int $parent, string $type[, string $connect = '' ]) : bool|string

Parameters

$id : int
$prim : string
$reference : array<string|int, mixed>
$parent : int
$type : string
$connect : string = ''

Return values

bool|string

quete_debut_pagination()

Trouver le numero de page d'une pagination indirecte lorsque debut_xxx=@123 on cherche la page qui contient l'item dont la cle primaire vaut 123


    
                    quete_debut_pagination(string $primary, int|string $valeur, int $pas, object $iter) : int

Parameters

$primary : string
$valeur : int|string
$pas : int
$iter : object

Return values

int

is_whereable()

Retourne true si ce where doit être appliqué, dans le cas des critères avec ? tel que `{id_article ?}`


    
                    is_whereable(mixed $value) : bool

Parameters

$value : mixed

Return values

bool

quete.php

Table of Contents

Functions

Functions

quete_virtuel()

Parameters

Return values

quete_parent_lang()

Parameters

Return values

quete_parent()

Parameters

Tags

Return values

quete_rubrique()

Parameters

Tags

Return values

quete_profondeur()

Parameters

Tags

Return values

quete_condition_postdates()

Parameters

Return values

quete_condition_statut()

Parameters

Return values

quete_fichier()

Parameters

Return values

quete_document()

Parameters

Return values

quete_meta()

Parameters

Return values

quete_logo()

Parameters

Tags

Return values

quete_logo_objet()

Parameters

Return values

quete_logo_file()

Parameters

Return values

quete_logo_document()

Parameters

Return values

quete_html_logo()

Parameters

Tags

Return values

document_spip_externe()

Parameters

Return values

vignette_logo_document()

Parameters

Return values

calcul_exposer()

Parameters

Return values

quete_debut_pagination()

Parameters

Return values

is_whereable()

Parameters

Return values