Méthode Categories_management :: Move_category_into_another_category
Move_category_in_another_category
Move_category_in_another_category — Déplace une catégorie au sein d'une catégorie parente (modifie l'ordre).
Cette méthode de la classe Categories_management permet de déplacer une catégorie dans une autre catégorie
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_in_another_category — Déplace une catégorie au sein d'une catégorie parente (modifie l'ordre).
Description
Code PHP :
bool Move_category_into_another_category(int $id, int $new_id_cat], int $position[)
Cette méthode de la classe Categories_management permet de déplacer une catégorie dans une autre catégorie
- $id est le numéro de la catégorie que nous souhaitons déplacer
- $new_id_cat est l'identifiant de la catégorie cible.
- $position est la position dans le classement (elle est facultative, si elle n'est pas spécifiée la catégorie sera placée à la fin)
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
- NEW_PARENT_CATEGORY_DOES_NOT_EXIST : la catégorie dans laquelle vous souhaitez déplacer cette catégorie n'existe pas
- NEW_CATEGORY_IS_IN_ITS_CHILDRENS : vous souhaitez déplacer la catégorie dans une de ses filles. Cela n'a pas de sens, cela romprait la notion d'arbre, c'est donc absolument impossible.
Voir aussi
- Move_category : permet de déplacer une catégorie à l'intérieur de sa catégorie mère (modifie juste l'ordre)
- Check_error : permet de déterminer quelle est la dernière erreur survenue