Action de création / modification d'un pense-bête
action_editer_pensebete_dist([null|int $arg = null ]) : array<string|int, mixed>
Identifiant du pense-bête. En absence utilise l'argument de l'action sécurisée.
Liste (identifiant du pense-bête, Texte d'erreur éventuel)
Crée un nouveau pense-bête et retourne son ID
pensebete_inserer([mixed $id_parent = null ][, array<string|int, mixed> $champs = [] ]) : int
Un tableau avec les champs par défaut lors de l'insertion
Identifiant du pense-bête créé
Modifie les données d'un pense-bête
pensebete_modifier(int $id_pensebete[, null|array<string|int, mixed> $set = null ]) : string
Récupère les valeurs qui ont été postées d'un formulaire d'édition automatiquement.
Identifiant du pense-bête
Couples de valeurs à affecter d'office
Vide en cas de succès, texte d'erreur sinon.
Action pour poser un Pense-bête depuis l'espace public
action_poser_pensebete_dist() : void
dans l'environnement le titre et le message du pensebête sont transmis mais l'émetteur et le recepteur sont dans les arguments sécurisés de l'action
Action pour répondre à une question dans un pense-bête (posée via son modele modeles/pd_reponse.html)
action_repondre_pensebete_dist([null|string $arg = null ]) : array<string|int, mixed>
Identifiant du pense-bête et type du formulaire utilisé pour la réponse En absence utilise l'argument de l'action sécurisée.
Liste (identifiant du pense-bête, Texte d'erreur éventuel)
Action pour supprimer un Pense-bête
action_supprimer_pensebete_dist([int $id_pensebete = null ]) : void
En réalité, c'est la déclaration de l'auteur comme receveur du pense-bête qui est supprimée, ce qui fait qu'il ne s'affiche plus (pour lui). Si l'auteur était le dernier receveur, alors le pense-bête effectivement est supprimé.
Identifiant de l'objet
Declaration de l'objet éditorial pensebetes
pensebetes_declarer_tables_objets_sql(array<string|int, mixed> $tables) : array<string|int, mixed>
Declaration de la table de liaison de l'objet éditorial pensebetes
pensebetes_declarer_tables_auxiliaires(array<string|int, mixed> $tables) : array<string|int, mixed>
Le plugin crée : une table de liaison pour les pense-bêtes 'spip_pensebetes_liens' une table des receveurs des pense-bêtes 'spip_pensebetes_receveurs'
Interfaces de la table pensebetes
pensebetes_declarer_tables_interfaces(array<string|int, mixed> $interfaces) : array<string|int, mixed>
Un simple formulaire de config, on a juste à déclarer les saisies
formulaires_configurer_pensebetes_saisies_dist() : mixed
Chargement des valeurs de SAISIES
formulaires_editer_pensebete_saisies_dist([mixed $id_pensebete = 'new' ][, mixed $id_parent = '' ][, mixed $retour = '' ][, mixed $associer_objet = '' ][, mixed $lier_trad = 0 ][, mixed $config_fonc = '' ][, mixed $row = [] ][, mixed $hidden = '' ]) : mixed
Aide à la création du formulaire avec le plugin SAISIES
Les valeurs sont calculées en fonction de la configuration mais aussi d'éventuelles autorisations qui permettent de gérer plus finement la configuration.
Chargement du formulaire d'édition de pensebete
formulaires_editer_pensebete_charger_dist([int|string $id_pensebete = 'new' ][, int $id_parent = '' ][, string $retour = '' ][, string $associer_objet = '' ][, int $lier_trad = 0 ][, string $config_fonc = '' ][, array<string|int, mixed> $row = [] ][, array<string|int, mixed> $hidden = '' ]) : mixed
Déclarer les champs postés et y intégrer les valeurs par défaut
identifiant de l'objet ou 'new' si absent.
identifiant de la rubrique.
lien pour le retour.
Éventuel 'objet|x' indiquant de lier le mot créé à cet objet, tel que 'article|3'
Identifier le formulaire en faisant abstraction des parametres qui ne representent pas l'objet edite
formulaires_editer_pensebete_identifier_dist([int|string $id_pensebete = 'new' ][, int $id_parent = '' ][, string $retour = '' ][, string $associer_objet = '' ][, int $lier_trad = 0 ][, string $config_fonc = '' ][, array<string|int, mixed> $row = [] ][, array<string|int, mixed> $hidden = '' ]) : mixed
identifiant de l'objet ou 'new' si absent.
identifiant de la rubrique.
lien pour le retour.
Éventuel 'objet|x' indiquant de lier le mot créé à cet objet, tel que 'article|3'
Vérification du formulaire d'édition de pensebete
formulaires_editer_pensebete_verifier_dist([int|string $id_pensebete = 'new' ][, int $id_parent = '' ][, string $retour = '' ][, string $associer_objet = '' ][, int $lier_trad = 0 ][, string $config_fonc = '' ][, array<string|int, mixed> $row = [] ][, array<string|int, mixed> $hidden = '' ]) : mixed
identifiant de l'objet ou 'new' si absent.
identifiant de la rubrique.
lien pour le retour.
Éventuel 'objet|x' indiquant de lier le mot créé à cet objet, tel que 'article|3'
Traitement du formulaire d'édition de pensebete
formulaires_editer_pensebete_traiter_dist([int|string $id_pensebete = 'new' ][, int $id_parent = '' ][, string $retour = '' ][, string $associer_objet = '' ][, int $lier_trad = 0 ][, string $config_fonc = '' ][, array<string|int, mixed> $row = [] ][, array<string|int, mixed> $hidden = '' ]) : mixed
Le traitement effectue une mise à zéro de l'id_auteur pour éviter des associations considérées comme inutiles.
identifiant de l'objet ou 'new' si absent.
identifiant de la rubrique.
lien pour le retour.
Éventuel 'objet|x' indiquant de lier le mot créé à cet objet, tel que 'article|3'
Traitement du formulaire d'édition
formulaires_traiter_pbq_dist(array<string|int, mixed> $champs) : string
Le traitement est nécessaire pour placer l'identifiant unique de l'auteur à qui la réponse sera apportée dans la variable id_rep.
Champs du formulaire du plugin inserer_modele
$code Arguments en ligne pour appeler le modèle
Permettre de créer et d'envoyer un pense-bête
inc_envoyer_pensebete_dist(int $id_donneur, array<string|int, mixed> $receveurs, string $titre, string $texte[, string $associer_objet = '' ]) : array<string|int, mixed>
auteur émetteur
auteurs bénéficaires
deux clés : auteurs_receveurs, la liste d'id d'auteurs
listes_receveurs, la liste des statuts
intitulé du pense-bête
message du pense-bête
objet auquel est éventuellement associé le pense-bête
$retours tableau
deux clés : ok boolean pour le succès
message string pour l'explication
Création et mise à jour du plugin Pensebetes
pensebetes_upgrade(string $nom_meta_base_version, string $version_cible) : void
version du schéma de données du plugin installé
Version déclarée dans paquet.xml
Faire le ménage lors de la désinstallation du plugin Pensebetes
pensebetes_vider_tables(string $nom_meta_base_version) : void
version du schéma de données du plugin installé
Fonction privée : remplacer les noms d'objet par les noms de table
cfg_1_0_2() : void
Permettre de conserver la configuration définie par les versions précédentes à la version 1.0.2
Fonction privée : remplacer les valeurs d’id_objet à zéro
cfg_1_0_4() : void
Comptabilité ascendante Permettre de conserver la configuration définie par les versions précédentes à la version 1.1.5
Fonction d'appel pour le pipeline
pensebetes_autoriser() : mixed
Autorisation d'associer un pensebete
autoriser_associerpensebetes_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $opt) : bool
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 un élément de menu (pensebetes)
autoriser_pensebetes_menu_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $opt) : bool
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 le bouton d'accès rapide de création (pensebete)
autoriser_pensebetecreer_menu_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $opt) : bool
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 le bouton d'outil collaboratif du mur
autoriser_murs_menu_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $opt) : bool
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 (pensebete)
autoriser_pensebete_creer_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $opt) : bool
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 pense-bête dont les destinataires seront les auteurs d'un certain statut
autoriser_pensebeteparstatut_creer_dist(string $faire, string $type, int $id, null|array<string|int, mixed>|int $qui, mixed $opt) : bool
Action demandée : creer
Type d'objet sur lequel appliquer l'action : objet _pensebete_par_statut
A noter que les underscores sont retirés par l'appel de la fonction autoriser
et qu'il convient de débuter le nom de l'objet par un underscore pour
préciser que ce n'est pas un objet.
Identifiant de l'objet : 0, liste
L'initiateur de l'action:
truesi l'auteur est autorisée à exécuter l'action, false sinon.
Autorisation de créer un pense-bête dont les destinataires peuvent être multiples
autoriser_pensebetemultiauteurs_creer_dist(string $faire, string $type, int $id, null|array<string|int, mixed>|int $qui, mixed $opt) : bool
Action demandée : creer
Type d'objet sur lequel appliquer l'action : objet _pensebete_multi_auteurs
A noter que les underscores sont retirés par l'appel de la fonction autoriser
et qu'il convient de débuter le nom de l'objet par un underscore pour
préciser que ce n'est pas un objet.
Identifiant de l'objet : 0, liste
L'initiateur de l'action:
truesi l'auteur est autorisée à exécuter l'action, false sinon.
Autorisation de voir (pensebete)
autoriser_pensebete_voir_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $opt) : bool
On peut voir les pensebetes dont on est l'auteur ou le destinataire.
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 modifier (pensebete)
autoriser_pensebete_modifier_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $opt) : bool
On peut modifier que les pensebetes dont on est l'auteur.
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 supprimer (pensebete)
autoriser_pensebete_supprimer_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $opt) : bool
On peut supprimer tous les pensebetes que l'on peut voir.
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'iconifier un pense-bête, c'est à dire lui mettre un logo.
autoriser_pensebete_iconifier_dist(string $faire, string $type, int $id, array<string|int, mixed> $qui, array<string|int, mixed> $opt) : bool
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
Ajout de la feuille de style de Pensebetes, dans l'espace public si demandé Appelé aussi depuis le privé avec $prive à true.
pensebetes_insert_head_css(array<string|int, mixed> $flux[, mixed $prive = false ]) : array<string|int, mixed>
Données du pipeline
Données du pipeline
Ajout de la CSS du Pensebetes au head privé
pensebetes_insert_head_prive_css(string $flux) : string
Contenu du head
Contenu du head complété
Ajout de contenu à gauche de la page,
pensebetes_affiche_gauche(array<string|int, mixed> $flux) : array<string|int, mixed>
Données du pipeline
Données du pipeline
Ajout de contenu sur certaines pages, notamment des formulaires de liaisons entre objets
pensebetes_affiche_milieu(array<string|int, mixed> $flux) : array<string|int, mixed>
Données du pipeline
Données du pipeline
Insérer des évènements dans le calendrier privé
pensebetes_quete_calendrier_prive(array<string|int, mixed> $flux) : array<string|int, mixed>
On y insère les Pense-bêtes de l'auteur. Les données sont formatées en json et utilisées par la librairie javascript Fullcalendar au travers du Plugin Organiseur.
Données du pipeline
Données du pipeline
Utiliser ce pipeline permet d'ajouter une aide au plugin,
pensebetes_aide_index(mixed $index) : array<string|int, mixed>
Données du pipeline
Permet d'agir sur le flux de données d'un fond
pensebetes_recuperer_fond(array<string|int, mixed> $flux) : array<string|int, mixed>
Ajout d'une aide en ligne relative à l'association sur le formulaire prive/formulaires/editer_liens.html Modification de la ligne :
<h3 class="titrem">[(#ENV{objet_source}|objet_info{texte_ajouter}|_T)]</h3>
Données du pipeline
Données du pipeline
Optimiser la base de données
pensebetes_optimiser_base_disparus(array<string|int, mixed> $flux) : array<string|int, mixed>
Appelé depuis ecrire/genie/optimiser.php, il permet de compléter le nettoyage des objets en supprimant des éléments lors des tâches périodiques.
Données du pipeline
Données du pipeline