Associer un album à un objet éditorial
action_associer_album_dist([string|null $arg = null ]) : bool
Arguments séparés par un slash /
sous la forme id_album/objet/id_objet
Remettre à zéro l'ordre des albums liés à un objet
action_desordonner_liens_albums_dist([string|null $arg = null ]) : void
Fournit les arguments de la fonction desordonner_liens_albums, séparés par des tirets.
Ex. : album-article-10-rang_lien
Remettre à zéro l'ordre des albums liés à un objet
desordonner_liens_albums(string $objet, string $objet_lie, mixed $id_objet_lie, string|null $champ_rang) : void
Type d'objet à dissocier (celui qui posséde la table de liens, les albums quoi)
Objet duquel dissocier
Numéro de l'objet duquel dissocier
Dissocier un ou tous les albums liés à un objet éditorial
action_dissocier_album_dist([string|null $arg = null ]) : bool
Arguments séparés par un slash /,
sous la forme id_album_ou_tous/objet/id_objet
tous pour dissocier en masseChanger le statut d'un album
action_instituer_album_dist([string $arg = null ]) : void
Arguments séparés par un charactère non alphanumérique
sous la forme $id_album/$statut
Ordonner les albums liés à un objet selon un ordre donné
action_ordonner_liens_albums_dist() : string
Objet json avec 3 clés done, success et errors
ordonner_liens_albums_json_envoi(mixed $data) : mixed
ordonner_liens_albums_json_erreur(mixed $msg) : mixed
Supprime un album proprement
action_supprimer_album_dist([mixed $arg = null ]) : void
string
Arguments séparés par un charactère non alphanumérique
sous la forme $id_album/orphelins
«Vider» un album : dissocier tous ses documents
action_vider_album_dist([mixed $arg = null ]) : void
Optionnellement, on peut supprimer les documents rendus orphelins, ainsi que l'album.
string
Arguments séparés par un charactère non alphanumérique
sous la forme $id_album-supprimer-orphelins
Fonction d'installation et de mise à jour du plugin.
albums_upgrade(string $nom_meta_base_version, string $version_cible) : void
Nom de la meta informant de la version du schéma de données du plugin installé dans SPIP
Version du schéma de données dans ce plugin (déclaré dans paquet.xml)
Fonction de désinstallation du plugin.
albums_vider_tables(string $nom_meta_base_version) : void
Nom de la meta informant de la version du schéma de données du plugin installé dans SPIP
Vérifie que les albums figurent dans la config des objets des documents.
albums_verifier_config_documents([array<string|int, mixed>|null $config = null ][, bool $ecrire = true ]) : array<string|int, mixed>
valeurs sous forme de tableau (à défaut on prend la config actuelle)
true pour enregistrer la nouvelle config (défaut)
Valeurs complétées
Écrit les valeurs par défaut de la configuration des albums
albums_ecrire_config_defaut() : bool
Fonction d'appel pour le pipeline
albums_autoriser() : mixed
Autorisation à afficher l'icone de création rapide.
autoriser_albumcreer_menu_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $options) : bool
Il faut être autorisé à créer un album.
Action demandée
Type d'objet sur lequel appliquer l'action
Identifiant de l'objet
Description de l'auteur demandant l'autorisation
Options de cette autorisation
true s'il a le droit, false sinon
Autorisation de voir les albums dans le menu d'édition.
autoriser_albums_menu_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $options) : bool
Il faut être autorisé à administrer les albums.
Action demandée
Type d'objet sur lequel appliquer l'action
Identifiant de l'objet
Description de l'auteur demandant l'autorisation
Options de cette autorisation
true s'il a le droit, false sinon
Autorisation de créer un album
autoriser_album_creer_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $options) : bool
Il faut être admin ou rédacteur.
Action demandée
Type d'objet sur lequel appliquer l'action
Identifiant de l'objet
Description de l'auteur demandant l'autorisation
Options de cette autorisation
true s'il a le droit, false sinon
Autorisation à voir un album
autoriser_album_voir_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $options) : bool
Open bar pour tout le monde.
Action demandée
Type d'objet sur lequel appliquer l'action
Identifiant de l'objet
Description de l'auteur demandant l'autorisation
Options de cette autorisation
true s'il a le droit, false sinon
Autorisation à accéder à l'albumothèque.
autoriser_albumotheque_administrer_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $options) : bool
Il faut être admin ou rédacteur.
Action demandée
Type d'objet sur lequel appliquer l'action
Identifiant de l'objet
Description de l'auteur demandant l'autorisation
Options de cette autorisation
true s'il a le droit, false sinon
Autorisation d'ajouter un album, optionnellement en le liant à un objet.
autoriser_ajouteralbum_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $options) : bool
Cette autorisation est prévue pour le formulaire ajouter_album.
Il faut avoir le droit de créer un album, et si un objet est indiqué, que l'ajout d'albums soit activé sur ce type, et avoir le droit de modifier l'objet ou être admin complet.
Action demandée
Type d'objet à lier à l'album (optionnel)
Identifiant de l'objet à lier à l'album
Description de l'auteur demandant l'autorisation
Options de cette autorisation
true s'il a le droit, false sinon
Autorisation à modifier un album.
autoriser_album_modifier_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $options) : bool
Il faut être l'auteur ou admin complet, ou si plugin autorité, que l'album soit dans un secteur wiki
Action demandée
Type d'objet sur lequel appliquer l'action
Identifiant de l'objet
Description de l'auteur demandant l'autorisation
Options de cette autorisation
true s'il a le droit, false sinon
Autorisation à supprimer définitivement un album.
autoriser_album_supprimer_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $options) : bool
Il faut avoir le droit de le modifier et qu'il soit à la poubelle, ou vide et inutilisé.
Action demandée
Type d'objet sur lequel appliquer l'action
Identifiant de l'objet
Description de l'auteur demandant l'autorisation
Options de cette autorisation
true s'il a le droit, false sinon
Autorisation à associer un album à un objet donné.
autoriser_album_associer_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $options) : bool
Il faut pouvoir modifier l'objet ou être admin complet
Action demandée
Type d'objet auquel on veut associer ou dissocier un album
Identifiant de l'objet auquel on veut associer ou dissocier un album
Description de l'auteur demandant l'autorisation
Options de cette autorisation
Doit contenir les clés objet et id_objet
pour rensigner le type et l'identifiant de l'objet
true s'il a le droit, false sinon
Autorisation à dissocier un album d'un objet donné.
autoriser_album_dissocier_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $options) : bool
Il faut pouvoir modifier l'objet ou être admin complet, et que l'album ne soit pas inséré dans le texte.
Action demandée
Type d'objet sur lequel appliquer l'action
Identifiant de l'objet
Description de l'auteur demandant l'autorisation
Options de cette autorisation
Doit contenir les clés objet et id_objet
pour renseigner le type et l'identifiant de l'objet
true s'il a le droit, false sinon
Autorisation à dissocier *tous* les albums d'un objet donné.
autoriser_dissocieralbums_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $options) : bool
Il faut plusieurs albums liés, et pouvoir modifier l'objet ou être admin complet.
Action demandée
Type d'objet sur lequel appliquer l'action
Identifiant de l'objet
Description de l'auteur demandant l'autorisation
Options de cette autorisation
true s'il a le droit, false sinon
Auto-association d'albums à du contenu éditorial qui le référence.
autoriser_autoassocieralbum_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $options) : bool
Par défaut true pour tous les objets.
Action demandée
Type d'objet sur lequel appliquer l'action
Identifiant de l'objet
Description de l'auteur demandant l'autorisation
Options de cette autorisation
true s'il a le droit, false sinon
Autorisation de vider un album
autoriser_album_vider_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $options) : bool
Il faut qu'il y ait des documents, et être admin complet
Action demandée
Type d'objet sur lequel appliquer l'action
Identifiant de l'objet
Description de l'auteur demandant l'autorisation
Options de cette autorisation
true s'il a le droit, false sinon
Différents tests utiles aux autorisations des albums
tester_autorisation_album(string $test, array<string|int, mixed> $args) : bool
Teste si un album se trouve dans un secteur wiki auquel on a accès (plugin autorité)
tester_album_wiki(int $id_album, array<string|int, mixed> $qui) : bool
critère `{orphelins}`
critere_ALBUMS_orphelins_dist(string $idb, object &$boucles, object $crit) : mixed
Sélectionne les albums sans lien avec un objet éditorial
Activer bigup sur le formulaire d'ajout d'album
inc_bigup_medias_formulaire_ajouter_album_dist(array<string|int, mixed> $args, Formulaire $formulaire) : Formulaire
Description des dispositions connues pour le modèle album.
albums_decrire_dispositions() : array<string|int, mixed>
On indique les traitements images éventuels, le modèle de doc à utiliser, etc. (parité avec les noms des paramètres du modèle album)
Tableau associatif avec la description de chaque disposition, clé * pour les valeurs de fallback.
Ajout de contenu aux fiches des objets.
albums_afficher_complement_objet(array<string|int, mixed> $flux) : array<string|int, mixed>
Données du pipeline Données du pipeline, tableau associatif :
type et idDonnées du pipeline
Ajout de contenu sur certaines pages.
albums_affiche_milieu(array<string|int, mixed> $flux) : array<string|int, mixed>
Données du pipeline
Données du pipeline
Modifier ou ajouter du contenu dans la colonne de gauche.
albums_affiche_gauche(array<string|int, mixed> $flux) : array<string|int, mixed>
Données du pipeline
Données du pipeline
Actions effectuées après l'insertion d'un nouvel objet en base.
albums_post_insertion(array<string|int, mixed> $flux) : array<string|int, mixed>
Données du pipeline
Données du pipeline
Actions effectuées après l'édition d'un objet.
albums_post_edition(array<string|int, mixed> $flux) : array<string|int, mixed>
Données du pipeline, tableau associatif :
action, table et id_objetDonnées du pipeline
Actions effectuées après l'édition des liens.
albums_post_edition_lien(array<string|int, mixed> $flux) : array<string|int, mixed>
Données du pipeline, tableau associatif :
action, table_lien, objet_source, id_objet_source, objet, id_objetDonnées du pipeline
Ajout de feuilles de style CSS sur les pages publiques
albums_insert_head_css(string $flux) : string
Feuilles de styles
Description complétée des feuilles de styles
Compter les albums liés à un objet
albums_objet_compte_enfants(array<string|int, mixed> $flux) : array<string|int, mixed>
Nb : on ne compte que les publiés afin que la publication/dépublication des rubrique fonctionne correctement
Données du pipeline
Données du pipeline
Afficher le nombre d'albums liés publiés dans la boîte infos des rubriques
albums_boite_infos(array<string|int, mixed> $flux) : array<string|int, mixed>
Données du pipeline
Données du pipeline
Optimiser la base de donnée en supprimant les liens orphelins
albums_optimiser_base_disparus(array<string|int, mixed> $flux) : array<string|int, mixed>
On supprime :
Données du pipeline
Données du pipeline
Compléter les vérifications des valeurs postées dans les formulaires
albums_formulaire_verifier(array<string|int, mixed> $flux) : array<string|int, mixed>
Modifier le résultat du calcul d'un squelette
albums_recuperer_fond(array<string|int, mixed> $flux) : array<string|int, mixed>
Données du pipeline
Données du pipeline
Ajouter des contenus dans la partie <head> des pages de l’espace privé
albums_header_prive(string $flux) : string
Rediriger possiblement vers un autre modèle album suivant la config de la variante
albums_styliser(string $flux) : string
Déclaration des alias de tables et filtres automatiques de champs
albums_declarer_tables_interfaces(array<string|int, mixed> $interfaces) : array<string|int, mixed>
Déclarations d'interface pour le compilateur
Déclarations d'interface pour le compilateur
Déclaration des objets éditoriaux
albums_declarer_tables_objets_sql(array<string|int, mixed> $tables) : array<string|int, mixed>
Description des tables
Description complétée des tables
Déclaration des tables secondaires (liaisons)
albums_declarer_tables_auxiliaires(array<string|int, mixed> $tables) : array<string|int, mixed>
Description des tables
Description complétée des tables
Identifier le formulaire en faisant abstraction des paramètres qui ne représentent pas l'objet edité
formulaires_ajouter_album_identifier_dist([int|string $objet = '' ][, int|string $id_objet = 0 ][, string $redirection = '' ][, int $lier_trad = 0 ][, array<string|int, mixed> $options = [] ]) : string
type d'un objet à associer (optionnel).
Identifiant d'un objet à associer (optionnel).
URL de redirection après le traitement
Identifiant éventuel d'un album source d'une traduction
Tableau d'options
Hash du formulaire
Chargement du formulaire d'ajout d'album
formulaires_ajouter_album_charger_dist([int|string $objet = '' ][, int|string $id_objet = 0 ][, string $redirection = '' ][, int $lier_trad = 0 ][, array<string|int, mixed> $options = [] ]) : array<string|int, mixed>
Déclarer les champs postés et y intégrer les valeurs par défaut
type de l'objet à associer.
Identifiant de l'objet à associer.
URL de redirection après le traitement
Identifiant éventuel d'un album source d'une traduction
Tableau d'options
Environnement du formulaire
Vérifications du formulaire d'ajout d'album
formulaires_ajouter_album_verifier_dist([int|string $objet = '' ][, int|string $id_objet = 0 ][, string $redirection = '' ][, int $lier_trad = 0 ][, array<string|int, mixed> $options = [] ]) : array<string|int, mixed>
Vérifier les champs postés et signaler d'éventuelles erreurs
type de l'objet à associer.
Identifiant de l'objet à associer.
URL de redirection après le traitement
Identifiant éventuel d'un album source d'une traduction
Tableau d'options
Tableau des erreurs
Traitement du formulaire d'ajout d'album
formulaires_ajouter_album_traiter_dist([int|string $objet = '' ][, int|string $id_objet = 0 ][, string $redirection = '' ][, int $lier_trad = 0 ][, array<string|int, mixed> $options = [] ]) : array<string|int, mixed>
Traiter les champs postés
type de l'objet à associer.
Identifiant de l'objet à associer.
URL de redirection après le traitement
Identifiant éventuel d'un album source d'une traduction
Tableau d'options
Tableau de retours des traitements id_album, ids_documents, message_ok, message_erreur
Fonction privée retournant le js pour recharger les blocs adéquats
js_ajouter_albums(array<string|int, mixed> $ajaxblocs[, array<string|int, mixed> $params = [] ][, array<string|int, mixed> $ids = [] ]) : string
identifiants de blocs ajax à recharger
identifiants des albums ajoutés
message js
Identifier le formulaire en faisant abstraction des paramètres qui ne représentent pas l'objet edité
formulaires_editer_album_identifier_dist([int|string $id_album = 'new' ][, string $retour = '' ][, string $associer_objet = '' ][, int $lier_trad = 0 ][, string $config_fonc = '' ][, array<string|int, mixed> $row = [] ][, string $hidden = '' ]) : string
Identifiant de l'album. 'new' pour un nouvel album.
URL de redirection après le traitement
Éventuel objet|x indiquant de lier l'album créé à cet objet,
tel que article|3
Identifiant éventuel d'un album source d'une traduction
Nom de la fonction ajoutant des configurations particulières au formulaire
Valeurs de la ligne SQL de l'album, si connu
Contenu HTML ajouté en même temps que les champs cachés du formulaire.
Hash du formulaire
Chargement du formulaire d'édition d'un album
formulaires_editer_album_charger_dist([int|string $id_album = 'new' ][, string $retour = '' ][, string $associer_objet = '' ][, int $lier_trad = 0 ][, string $config_fonc = '' ][, array<string|int, mixed> $row = [] ][, string $hidden = '' ]) : array<string|int, mixed>
Déclarer les champs postés et y intégrer les valeurs par défaut
Identifiant de l'album. 'new' pour un nouvel album.
URL de redirection après le traitement
Éventuel objet|x indiquant de lier le album créé à cet objet,
tel que article|3
Identifiant éventuel d'un album source d'une traduction
Nom de la fonction ajoutant des configurations particulières au formulaire
Valeurs de la ligne SQL de l'album, si connu
Contenu HTML ajouté en même temps que les champs cachés du formulaire.
Environnement du formulaire
Vérifications du formulaire d'édition d'un album
formulaires_editer_album_verifier_dist([int|string $id_album = 'new' ][, string $retour = '' ][, string $associer_objet = '' ][, int $lier_trad = 0 ][, string $config_fonc = '' ][, array<string|int, mixed> $row = [] ][, string $hidden = '' ]) : array<string|int, mixed>
Vérifier les champs postés et signaler d'éventuelles erreurs
Identifiant de l'album. 'new' pour un nouvel album.
URL de redirection après le traitement
Éventuel objet|x indiquant de lier le album créé à cet objet,
tel que article|3
Identifiant éventuel d'un album source d'une traduction
Nom de la fonction ajoutant des configurations particulières au formulaire
Valeurs de la ligne SQL de l'album, si connu
Contenu HTML ajouté en même temps que les champs cachés du formulaire.
Tableau des erreurs
Traitement du formulaire d'édition d'un album
formulaires_editer_album_traiter_dist([int|string $id_album = 'new' ][, string $retour = '' ][, string $associer_objet = '' ][, int $lier_trad = 0 ][, string $config_fonc = '' ][, array<string|int, mixed> $row = [] ][, string $hidden = '' ]) : array<string|int, mixed>
Traiter les champs postés
Identifiant de l'album. 'new' pour un nouvel album.
URL de redirection après le traitement
Éventuel objet|x indiquant de lier le album créé à cet objet,
tel que article|3
Identifiant éventuel d'un album source d'une traduction
Nom de la fonction ajoutant des configurations particulières au formulaire
Valeurs de la ligne SQL de l'album, si connu
Contenu HTML ajouté en même temps que les champs cachés du formulaire.
Retours des traitements
Chargement du formulaire de migration d'articles en albums
formulaires_migrer_albums_charger_dist() : array<string|int, mixed>
Déclarer les champs postés et y intégrer les valeurs par défaut
Environnement du formulaire
Vérifications du formulaire de migration d'articles en albums
formulaires_migrer_albums_verifier_dist() : array<string|int, mixed>
Vérifier les champs postés et signaler d'éventuelles erreurs
Tableau des erreurs
Traitement du formulaire de migration d'articles en albums
formulaires_migrer_albums_traiter_dist() : array<string|int, mixed>
Traiter les champs postés
Retours des traitements
Fonction privée
albums_migrer_articles(mixed $where_articles, mixed $where_mots, mixed $refuser, mixed $lier_rubriques) : int
nombre d'articles migrés
Fonction privée
migrer_albums_where_articles(mixed $id_rubrique[, mixed $branche = false ]) : array<string|int, mixed>
Fonction privée
migrer_albums_where_mots(mixed $groupes) : array<string|int, mixed>
Chargement du formulaire de migration d'articles en albums
formulaires_migrer_portfolio_charger_dist() : array<string|int, mixed>
Déclarer les champs postés et y intégrer les valeurs par défaut
Environnement du formulaire
Vérifications du formulaire de migration d'articles en albums
formulaires_migrer_portfolio_verifier_dist() : array<string|int, mixed>
Vérifier les champs postés et signaler d'éventuelles erreurs
Tableau des erreurs
Traitement du formulaire de migration d'articles en albums
formulaires_migrer_portfolio_traiter_dist() : array<string|int, mixed>
Traiter les champs postés
Retours des traitements
Supprimer proprement un ou plusieurs albums
supprimer_albums(mixed $ids_albums[, bool $supprimer_docs_orphelins = false ]) : mixed
spip_documents_liensspip_albums_lienstrue pour supprimer les documents rendus orphelins
Vider un ou plusieurs albums de leurs documents.
vider_albums(mixed $ids_albums[, bool $supprimer_docs_orphelins = false ]) : array<string|int, mixed>
true pour supprimer les documents rendus orphelins
tableau des albums vidés et ceux laissés intacts [succes => [x,y,z]],[erreurs => [x,y,z]]
Transvaser les documents entre un album et un objet éditorial auquel il est associé
transvaser_album(int|string $id_album, string $objet, int $id_objet[, bool $remplir = true ][, bool $supprimer = false ]) : int|bool
Identifiant de l'album 0 pour créer un nouvel album vide, dans le cas d'un remplissage
Type d'objet
Identifiant de l'objet
Définit le sens du transvasement (on remplit l'album ou on le vide) true : portfolio -> album false : album -> portfolio
true : supprimer l'album dans le cas d'un vidage
nb de liens changés si ok, false en cas d'erreur
Lister les formulaire yaml des modèles «album» disponibles dans les dossiers modeles/
albums_lister_modeles() : array<string|int, mixed>
Les premiers modèles retournés sont les modèles du plugin (album.yaml et album_liste.yaml)
Charger les informations d'un formulaire yaml de modèle «album»
infos_modele_album(mixed $fichier) : array<string|int, mixed>
Vérifier les albums insérés dans le texte d'un objet et mettre à jour les liens.
inc_marquer_doublons_albums_dist(mixed $champs, mixed $id, mixed $type, mixed $id_table_objet, mixed $table_objet, mixed $table_objet_sql[, mixed $desc = [] ][, mixed $serveur = '' ]) : array<string|int, mixed>
Utiliser charger_fonction('objet_marquer_albums_inseres', 'inc') à la place.
Fonction publique
albums_migrer_portfolio([array<string|int, mixed> $objets = ['article', 'rubrique'] ][, string $titre = '' ]) : int
nombre d'albums créés
Vérifier les albums insérés dans le texte d'un objet et mettre à jour les liens.
inc_objet_marquer_albums_inseres_dist(string $objet, int $id_objet, array<string|int, mixed> $data[, string $serveur = '' ]) : array<string|int, mixed>
On cherche les occurences des raccourcis des modèles d'albums <albumxx> dans une liste de champs prédéfinie,
et on met à jour le champ vu des albums liés en fonction.
On reprend la liste du plugin médias qui cherche dans chapo et texte par défaut.
Liste extensible en complétant $GLOBALS['medias_liste_champs'].
Type d'objet
Identifiant de l'objet
Liste complète ou partielle des couples champ => valeur de l'objet En cas de liste partielle, les couples manquants sont récupérés automatiquement
Nom du connecteur
Liste d'ids des albums insérés dans le texte
Prend le retour d'un collecteur de modele et renvoie la liste des albums
albums_collecteur2id(array<string|int, mixed> $collection) : array<string|int, mixed>
Retourne les valeurs à charger pour un formulaire d'édition d'un album
inc_precharger_album_dist(string|int $id_album[, int $id_rubrique = 0 ][, int $lier_trad = 0 ]) : array<string|int, mixed>
Lors d'une création, certains champs peuvent être préremplis (c'est le cas des traductions)
Identifiant de l'album, ou "new" pour une création
Identifiant éventuel de la rubrique parente
Identifiant éventuel de la traduction de référence
Couples clés / valeurs des champs du formulaire à charger.
Récupère les valeurs d'une traduction de référence pour la création d'un album (préremplissage du formulaire).
inc_precharger_traduction_album_dist(string|int $id_album[, int $id_rubrique = 0 ][, int $lier_trad = 0 ]) : array<string|int, mixed>
Identifiant de l'album, ou "new" pour une création
Identifiant éventuel de la rubrique parente
Identifiant éventuel de la traduction de référence
Couples clés / valeurs des champs du formulaire à charger
Compile la balise `#ALBUM_DOC` qui retourne le code HTML d'un modèle de document ajusté pour les albums.
balise_ALBUM_DOC_dist(object $p) : object
Utilise en général un modèle standard #DOC auquel on ajoute des attributs
et applique des traitements d'images.
Le choix du modèle et les traitements dépendent de la disposition de l'album et du contexte.
S'utilise uniquement dans une boucle documents ou documents_liens.
Pile au niveau de la balise
Pile complétée par le code à générer
Fonction privée pour calculer le HTML de la balise #ALBUM_DOC
calculer_album_doc(array<string|int, mixed> $document, array<string|int, mixed> $contexte) : string
Tableau d'infos sur le document array<int id_document, string media, int largeur, int hauteur>
Contexte d'appel du modèle, sans les trucs par défaut inutiles (date, date_redac, etc.)
Compile la balise `#ALBUM_PARAMS` qui retourne soit un ensemble de valeurs utiles au modèle album, soit une seule.
balise_ALBUM_PARAMS_dist(object $p) : object
Pile au niveau de la balise
Pile complétée par le code à générer
Fonction privée pour calculer la balise `#ALBUM_PARAMS`
calculer_album_params([array<string|int, mixed> $contexte = [] ][, string|null $param = null ]) : array<string|int, mixed>|string
En fonction du contexte, de la config et des défauts, on choisit la disposition, le modèle pour les documents, les valeurs pour les traitements à appliquer aux images, etc.
Chaque disposition a ses propres traitements d'image et options par défaut.
Environnement du modèle, sans les trucs par défaut inutiles (date, date_redac, etc.)
Soit un tableau de params : array<string disposition, string modele_doc, string recadrer_ratio, string recadrer_sens, int largeur, int hauteur, bool images> Soit la valeur d'un param
Nettoyer le contexte pour ne garder que les trucs en rapport avec le modèle
nettoyer_contexte_modele_album([array<string|int, mixed>|null $contexte = [] ]) : void
Permet de calculer un hash
Renvoie un identifiant unique pour le modèle
calculer_id_modele_album(array<string|int, mixed>|null $contexte) : string
Dépend de la façon dont sont sélectionnés les documents : soit via id_album, soit id_patate, etc.
Renvoie une classe correspondant à un ratio
albums_classe_ratio(string $ratio) : string
Indique le format le plus proche : carré, portrait ou paysage Ainsi que le ratio entier le plus proche : 2:1, 3:1
Pour le ratio on arrondit à l'entier le plus proche, ex. : 2.21:1 → 2:1 → 2
Ratio sous la forme 1:1
format-square, format-landscape_2, format-portrait_3, etc.
Compile le critère `{documents_album}`
critere_DOCUMENTS_documents_album_dist(string $idb, object &$boucles, object $crit) : void
Rustine pour forcer une jointure en LEFT avec les documents liés. Des fois le compilo fait du caca : plusieurs jointures sur la même table, et ça pète les conditions dans le WHERE.
Identifiant de la boucle
AST du squelette
Paramètres du critère dans cette boucle
Ajoute les attributs nécessaires à une boîte album dans le privé
filtre_inserer_attributs_album(string $texte, string $id_album) : string
Rustine car |inserer_attribut ne fonctionne pas dans tous les cas
Chercher la liste des disposition et en fournit un argument `data` pour saisies En mettant notamment le svg et le title
albums_disposition_saisies_data() : array<string|int, mixed>