Méthode Categories_management :: Move_category
Move_category
Move_category — Déplace une catégorie au sein d'une catégorie parente (modifie l'ordre).
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 :
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.
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) :
Move_category — Déplace une catégorie au sein d'une catégorie parente (modifie l'ordre).
Description
Code PHP :
bool Move_category(int $id, $way)
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