PHPBoost CMS

Move_category
Move_category — Déplace une catégorie au sein d'une catégorie parente (modifie l'ordre).

Description

[code=php,0,0]bool Move_category(int $id, $way)[/code]

Cette méthode de la classe Categories_management déplace une catégorie au sein d'une même catégorie parente (monter ou descendre dans le classement). Voici les arguments qu'elle admet :

• $id est le numéro de la catégorie que nous souhaitons déplacer
• $way est le sens dans lequel nous voulons déplacer la catégorie. Utilisez la constante MOVE_CATEGORY_UP si vous souhaitez la faire monter, MOVE_CATEGORY_DOWN sinon.
  

Valeur de retour

Cette méthode renvoie vrai si le déplacement a été effectué avec succès, et faux sinon. Si le déplacement a échoué, vous pourrez savoir quelle erreur s'est produite en utilisant la méthode Check_error.

Différentes sources d'erreurs

Nous allons voir les sources possibles d'erreur (utilisez la méthode[ link=methode-categories-management-check-error]Check_error[/link] pour savoir quelle erreur s'est produite). Voici les constantes que vous pouvez tester dans ce cas et ce à quoi elles correspondent (très utile pour le débuggage) :

• CATEGORY_DOES_NOT_EXIST : la catégorie que vous souhaitez déplacer n'existe pas
• ERROR_CAT_IS_AT_BOTTOM : la catégorie que vous voulez descendre est déjà en dernière position
• ERROR_CAT_IS_AT_TOP : la catégorie que vous souhaitez monter est déjà en première position
• ERROR_UNKNOWN_MOTION : vous avez demandé un déplacement inconnu
  

Voir aussi

• Move_category_in_another_category : déplace une catégorie dans une autre catégorie (plus général que la méthode Move_category).
• Check_error : permet de déterminer quelle est la dernière erreur survenue