Fichier ecrire/action/editer_article.php

Gestion de l'action editer_article et de l'API d'édition d'un article

Source

Proposer une amélioration

Liste des fonctions

Si aucun identifiant n'est donné, on crée alors un nouvel article, à condition que la rubrique parente (id_rubrique) puisse être obtenue (avec _request())

array action_editer_article_dist( null | integer $arg = null )

Paramètres

  1. null | integer $arg = null

    Identifiant de l'article. En absence utilise l'argument de l'action sécurisée.

Retour

  • array

    Liste (identifiant de l'article, Texte d'erreur éventuel)

Package

Proposer une amélioration

En plus des données enregistrées par défaut, la fonction :

  • retrouve un identifiant de rubrique pour stocker l'article (la première rubrique racine) si l'identifiant de rubrique transmis est nul.

  • calcule la langue de l'article, soit

    • d'après la langue de la rubrique si les articles ne sont pas configurés comme pouvant être traduits,

    • d'après la langue de l'auteur en cours si les articles peuvent être traduits et si la langue de l'auteur est acceptée en tant que langue de traduction
  • crée une liaison automatiquement entre l'auteur connecté et l'article créé, de sorte que la personne devient par défaut auteur de l'article qu'elle crée.
integer article_inserer( integer $id_rubrique , array | null $set = null )

Paramètres

  1. integer $id_rubrique

    Identifiant de la rubrique parente

  2. array | null $set = null

Retour

  • integer

    Identifiant du nouvel article

Appelle le pipeline

Variables globales

  • array meta
  • array visiteur_session
  • string spip_lang

Package

Proposer une amélioration

Modifie la langue, la rubrique ou les statuts d'un article.

string article_instituer( integer $id_article , array $c , boolean $calcul_rub = true )

Paramètres

  1. integer $id_article

    Identifiant de l'article

  2. array $c

    Couples (colonne => valeur) des données à instituer Les colonnes 'statut' et 'id_parent' sont liées, car un admin restreint peut deplacer un article publié vers une rubrique qu'il n'administre pas

  3. boolean $calcul_rub = true

    True pour changer le statut des rubriques concernées si un article change de statut ou est déplacé dans une autre rubrique

Retour

  • string

    Chaîne vide

Appelle le pipeline

Variables globales

  • array $GLOBALS ['meta']

Package

Proposer une amélioration

Appelle toutes les fonctions de modification d'un article

string | null article_modifier( integer $id_article , array | null $set = null )

Paramètres

  1. integer $id_article

    Identifiant de l'article à modifier

  2. array | null $set = null

    Couples (colonne => valeur) de données à modifier. En leur absence, on cherche les données dans les champs éditables qui ont été postés (via collecter_requests())

Retour

  • string | null
    • Chaîne vide si aucune erreur,
    • Null si aucun champ à modifier,
    • Chaîne contenant un texte d'erreur sinon.

Package

Proposer une amélioration
void | null editer_article_heritage( integer $id_article , integer $id_rubrique , string $statut , array $champs , boolean $cond = true )

Paramètres

  1. integer $id_article

    Identifiant de l'article

  2. integer $id_rubrique

    Identifiant de la rubrique parente

  3. string $statut

    Statut de l'article (prop, publie, ...)

  4. array $champs

    Couples (colonne => valeur) des champs qui ont été modifiés

  5. boolean $cond = true

    True pour actualiser le statut et date de publication de la rubrique parente si nécessaire

Retour

  • void | null

    null si aucune action à faire void sinon

Variables globales

  • array $GLOBALS ['meta']

Package

Proposer une amélioration

Dépréciées

string | null articles_set( integer $id_article , array | null $set = null )

Paramètres

  1. integer $id_article

    Identifiant de l'article à modifier

  2. array | null $set = null

    Couples (colonne => valeur) de données à modifier. En leur absence, on cherche les données dans les champs éditables qui ont été postés (via _request())

Retour

  • string | null

    Chaîne vide si aucune erreur, Null si aucun champ à modifier, Chaîne contenant un texte d'erreur sinon.

Voir également

Package

Deprecated

  • Utiliser article_modifier()
Proposer une amélioration
integer insert_article( integer $id_rubrique )

Paramètres

  1. integer $id_rubrique

    Identifiant de la rubrique

Retour

  • integer

    Identifiant du nouvel article

Voir également

Package

Deprecated

  • Utiliser article_inserer()
Proposer une amélioration
string instituer_article( integer $id_article , array $c , boolean $calcul_rub = true )

Paramètres

  1. integer $id_article

    Identifiant de l'article

  2. array $c

    Couples (colonne => valeur) des données à instituer Les colonnes 'statut' et 'id_parent' sont liées, car un admin restreint peut deplacer un article publié vers une rubrique qu'il n'administre pas

  3. boolean $calcul_rub = true

    True pour changer le statut des rubriques concernées si un article change de statut ou est déplacé dans une autre rubrique

Retour

  • string

    Chaîne vide

Voir également

Package

Deprecated

  • Utiliser article_instituer()
Proposer une amélioration
string | null revision_article( integer $id_article , array | null $c = false )

Paramètres

  1. integer $id_article

    Identifiant de l'article à modifier

  2. array | null $c = false

    Couples (colonne => valeur) de données à modifier. En leur absence, on cherche les données dans les champs éditables qui ont été postés (via _request())

Retour

  • string | null

    Chaîne vide si aucune erreur, Null si aucun champ à modifier, Chaîne contenant un texte d'erreur sinon.

Voir également

Package

Deprecated

  • Utiliser article_modifier()
Proposer une amélioration
string | null revisions_articles( integer $id_article , array | null $c = false )

Paramètres

  1. integer $id_article

    Identifiant de l'article à modifier

  2. array | null $c = false

    Couples (colonne => valeur) de données à modifier. En leur absence, on cherche les données dans les champs éditables qui ont été postés (via _request())

Retour

  • string | null

    Chaîne vide si aucune erreur, Null si aucun champ à modifier, Chaîne contenant un texte d'erreur sinon.

Voir également

Package

Deprecated

  • Utiliser article_modifier()
Proposer une amélioration