Changeset 88148 in spip-zone for _plugins_/albums

Timestamp:

Mar 22, 2015, 4:53:51 PM (6 years ago)

Author:

tcharlss@…

Message:

Fonction pour "transvaser" les documents entre un album et le portfolio d'un objet (portfolio = tous les docs liés à l'objet, pas juste le groupe "porfolio". On se comprend.).
Autrement dit, ça permet de "transformer" un portfolio en album et inversement.
Pour l'instant, les boutons d'action correspondant ne sont pas intégrés dans l'interface, le temps de trouver comment faire ça proprement.
Il faut un libellé clair et pas trop long pour ces boutons (albumiser / désalbumiser ? transvaser ?...).
Quand les afficher : pour les admins, les rédacteurs ?
Que de questions.

Location:

_plugins_/albums/trunk

Files:

• albums_autorisations.php (modified) (3 diffs)
• inc/albums.php (modified) (2 diffs)

_plugins_/albums/trunk/albums_autorisations.php

@@ -324 +324 @@
  * Autorisation à supprimer définitivement un album.
  *
- * Il faut qu'il soit vide et inutilisé, + non publié si on est pas admin complet
+ * Il faut qu'il soit vide et inutilisé, et avoir le droit de le modifier ou être admin complet
  *
  * @param  string $faire Action demandée
@@ -414 +414 @@
  * @param  array  $opts  Options de cette autorisation
  *                       Doit contenir les clés `objet` et `id_objet`
- *                       pour rensigner le type et l'identifiant de l'objet
+ *                       pour renseigner le type et l'identifiant de l'objet
  * @return bool          true s'il a le droit, false sinon
  */
@@ -505 +505 @@
 **/
 function autoriser_album_vider_dist($faire, $type, $id, $qui, $opts) {
+
         include_spip('action/editer_liens');
         $rempli = count(objet_trouver_liens(array('document'=>'*'),array('album'=>$id)))>0;
         $admin = $qui['statut']=='0minirezo' AND !$qui['restreint'];
         $autoriser = ($admin AND $rempli) ? true : false;
+
+        return $autoriser;
+}
+
+
+/**
+ * Autorisation de transvaser les documents d'un album
+ *
+ * Il faut que l'album soit lié à l'objet et 
+ * avoir le droit de modifier l'album et d'ajouter des documents ou être admin complet.
+ *
+ * @param  string $faire Action demandée
+ * @param  string $type  Type d'objet sur lequel appliquer l'action
+ * @param  int    $id    Identifiant de l'objet
+ * @param  array  $qui   Description de l'auteur demandant l'autorisation
+ * @param  array  $opts  Options de cette autorisation
+ *                       Doit contenir les clés `objet` et `id_objet`
+ *                       pour renseigner le type et l'identifiant de l'objet
+ * @return bool          true s'il a le droit, false sinon
+**/
+function autoriser_album_transvaser_dist($faire, $type, $id, $qui, $opts) {
+
+        include_spip('action/editer_liens');
+        $objet = $opts['objet'];
+        $id_objet = $opts['id_objet'];
+        $liaison = (count(objet_trouver_liens(array('album'=>$id),array($objet=>$id_objet)))>0) ? true : false;
+        $autoriser_modifier = autoriser('modifier','album',$id);
+        $autoriser_joindredocument = autoriser('joindredocument',$objet,$id_objet);
+        $admin = $qui['statut']=='0minirezo' AND !$qui['restreint'];
+
+        $autoriser = (
+                $liaison
+                AND
+                (
+                        (
+                        $autoriser_modifier
+                        AND $autoriser_joindredocument
+                        )
+                        OR
+                        $admin
+                )
+        ) ? true : false;
+
         return $autoriser;
 }

_plugins_/albums/trunk/inc/albums.php

@@ -80 +80 @@
         include_spip('inc/autoriser');
         include_spip('action/editer_liens');
+
         foreach($ids_albums as $id_album) {
                 if (
@@ -105 +106 @@
 
 /**
+ * Transvaser les documents entre un album et un objet éditorial auquel il est associé
+ *
+ * @note
+ * On ne fait que modifier des liens existants au lieu de dissocier puis réassocier
+ * les documents au moyen des fonctions de Médias (`dissocier_document` et `associer_document`)
+ *
+ * @param int|string $id_album
+ *     Identifiant de l'album
+ *     0 pour créer un nouvel album vide, dans le cas d'un remplissage
+ * @param string $objet
+ *     Type d'objet
+ * @param int $id_objet
+ *     Identifiant de l'objet
+ * @param bool $remplir
+ *     Définit le sens du transvasement (on remplit l'album ou on le vide)
+ *     true  : portfolio -> album
+ *     false : album     -> portfolio
+ * @param bool $supprimer
+ *     true : supprimer l'album dans le cas d'un vidage
+ * @return int|bool
+ *     nb de liens changés si ok,
+ *     false en cas d'erreur
+ */
+function transvaser_album($id_album, $objet, $id_objet, $remplir=true, $supprimer=false) {
+
+        include_spip('inc/autoriser');
+        include_spip('action/editer_liens');
+        include_spip('action/editer_objet');
+
+        $echec = null;
+        $nb_maj = 0;
+
+        // au besoin, on crée d'abord un album et on l'associe à l'objet
+        if (
+                !intval($id_album)
+                AND $remplir === true
+        ) {
+                $id_album = objet_inserer('album');
+                objet_associer(array('album'=>$id_album),array($objet=>$id_objet));
+        }
+
+        if (autoriser('transvaser','album',$id_album,'',array('objet'=>$objet,'id_objet'=>$id_objet))){
+
+                $objet_source = ($remplir === true) ? $objet : 'album';
+                $id_objet_source = ($remplir === true) ? $id_objet : $id_album;
+                $objet_destination = ($remplir === true) ? 'album' : $objet;
+                $id_objet_destination = ($remplir === true) ? $id_album : $id_objet;
+
+                // changer les liens existants
+                // on ne peut pas changer objet et id_objet avec objet_qualifier_liens, donc on fait ça à la main
+                if (
+                        $liens_docs = objet_trouver_liens(array('document'=>'*'),array($objet_source=>$id_objet_source))
+                        AND is_array($liens_docs)
+                ){
+                        foreach ($liens_docs as $lien){
+                                $qualif = array('objet'=>$objet_destination,'id_objet'=>$id_objet_destination);
+                                $where = 'id_document='.intval($lien['id_document']).' AND objet='.sql_quote($objet_source).' AND id_objet='.intval($id_objet_source);
+                                $res = sql_updateq('spip_documents_liens',$qualif,$where);
+                                if ($res===false)
+                                        $echec = true;
+                                else
+                                        $nb_maj++;
+                        }
+                }
+                // en cas de vidage, dissocier l'album
+                // puis éventuellement le supprimer
+                if (
+                        $remplir === false
+                        AND $echec !== false
+                ){
+                        objet_dissocier(array('album'=>$id_album),array($objet=>$id_objet));
+                        if (
+                                $supprimer === true
+                                AND autoriser('supprimer','album',$id_album)
+                        ) {
+                                supprimer_albums($id_album);
+                        }
+                }
+        } else {
+                $echec = true;
+        }
+        return ($echec?false:$nb_maj);
+}
+
+
+/**
  * Lister les formulaire yaml des modèles «album» disponibles dans les dossiers modeles/
  *