Documentations

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).


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
Cette page a été vue 2403 fois