Changeset 83558 in spip-zone


Ignore:
Timestamp:
Jul 6, 2014, 7:52:45 PM (5 years ago)
Author:
tcharlss@…
Message:

Passage du trunk en dev.
On convertit le todo + règles de commit en fichiers markdown, et ajout d'un fichier de notes sur les mise à jour : MAJ.md.
Pour les mise à jour en question, on verra demain.

Location:
_plugins_/albums/trunk
Files:
1 added
1 edited
2 moved

Legend:

Unmodified
Added
Removed
  • _plugins_/albums/trunk/REGLES DE COMMIT.md

    r81747 r83558  
    1 ==================================
    2 Plugin Albums 2 : règles de commit
    3 ==================================
     1Plugin Albums : règles de commit
     2================================
    43
    5 Pour faire simple : tout le monde est encouragé à commiter dans la mesure ou ça ne bouleverse pas l'utilisation ou l'apparence du plugin.
    6 Si c'est le cas, rendez-vous sur la liste de discussion spip-zone pour en discuter.
     4Tout le monde est encouragé à commiter dans la mesure ou ça ne bouleverse pas l'utilisation ou l'apparence du plugin.
     5Si c'est le cas, rendez-vous sur la liste de discussion spip-zone ou sur IRC pour en discuter.
    76
    8 ==========
    9 Squelettes
    10 ==========
    11 En cas d'ajout de nouveaux squelettes, pensez aux autres contributeurs.
    12 Chaque squelette devrait commencer par un [(#REM) ... ] expliquant la fonction du squelette, les paramètres s'il s'agit d'une inclusion, et éventuellement le squelette appelant.
    13 Les commentaires dans la page sont vivement encouragés.
     7## Squelettes
    148
    15 =======
    16 Modèles
    17 =======
    18 Le plugin n'a pas vocation à fournir nombre de variantes différentes.
    19 C'est aux autres plugins qui reposent sur les documents de proposer des variantes de modèles Album.
    20 On s'en tient donc aux 2 modèles de base, en cas d'idée géniale pour un nouveau modèle, discutons en avant.
    21 De plus, les styles publics des 2 modèles doivent être le plus minimal possible, afin d'être facilement surchargeables.
     9En cas d'ajout de squelettes ou de code php, pensez aux autres contributeurs : commentez !
     10Chaque squelette devrait commencer par 1 à 3 commentaires expliquant certains points :
    2211
    23 ========================
    24 Styles de l'espace privé
    25 ========================
    26 On essaie de rester sobre, et de respecter tant que faire se peut la charte de SPIP.
    27 Pour info, une charte est dispo page ?exec=charte après installation du plugin 'développement'.
     12- la description du squelette.
     13- les squelettes utilisés, et ceux où il est inclus.
     14- les paramètres éventuels.
     15
     16Exemple complet :
     17
     18    [(#REM)
     19
     20        Description du squelette
     21
     22    ][(#REM)
     23   
     24        Utilise :
     25            inclure/noisette.html
     26        Inclus dans :
     27            prive/squelettes/contenu/truc.html
     28
     29    ][(#REM)
     30
     31        Paramètres (*obligatoire):
     32            *param1    explication param1
     33            param2     explication param2
     34
     35    ]
     36
     37## Modèles
     38
     39Le plugin ne fournit que 2 variantes pour le modèle `<album>` : une vue «vignettes» par défaut et une variante «liste».
     40Ces 2 modèles sont minimalistes par choix : ils ont vocation à être surchargés.
     41On s'en tient donc à ces 2 modèles de base, en cas d'idée géniale pour un nouveau modèle, discutons en avant.
     42
     43### Ajouter des modèles
     44
     45Les plugins qui se servent des albums peuvent ajouter des variantes du modèle `<album>`, pour des diaporamas, des playlists etc.
     46Le principe du plugin «Insérer modèles» est repris.
     47A chaque variante du modèle doit correspondre un fichier yaml contenant les saisies des options du modèle.
     48Ce fichier yaml sert au formulaire qui permet de générer une balise `<album>` à insérer dans le texte, en mode édition.
     49
     50Par exemple, pour ajouter une variante «diaporama», il faut :
     51
     52- un fichier `album_diaporama.html`
     53- un fichier `album_diaporama.yaml`. Il y a 4 saisies obligatoires : `modele`, `id_modele`, `id_album` et `variante`. Voir pour exemple `album_liste.yaml`
  • _plugins_/albums/trunk/TODO.md

    r81747 r83558  
    1 ===========
    2 v 2.2 / 2.3
    3 ===========
     1Plugin Albums : todo
     2====================
    43
    5 - Modèles
    6   reprendre les fonctionnement de la v1 qui surcharge le portfolio pour y inclure les albums ?
     4Liste de choses à faire, sans version particulière ciblée.
    75
    8 - Pipeline affiche_gauche (édition d'un objet)
    9   Afficher le liste des albums un peu a la façon du plugin 'médias', avec une touche du plugin 'insérer modèles'.
    10     -> Pouvoir créer ou associer un album
    11     -> générer les balises en fonction des variantes de modèles dispo, et insertion dans le texte automatique ou au double clic
    12  
    13 - Fichiers surchargés du plugin medias :
    14   Plusieurs fichiers sont surchargés à cause de pb javascripts, à terme il faudrait s'en passer.
     6## Liste des albums liés
    157
    16         * prive/squelettes/inclure/portfolio-documents (Modif incluse à partir de SPIP 3.06)
    17                 pb javascript quand plusieurs portfolios sont affichés en même temps.
    18                 Ajout d'un id unique aux blocs #portfolios, #illustrations, #documents et #portfolio
     8- Bouton pour dépacer les documents d'un album dans le portfolio.
     9- Bouton pour déplacer les documents du portfolio dans un nouvel album.
    1910
    20         * formulaires/inc-upload_documents.html
    21                 pb javascript quand plusieurs formulaires sont affichés en même temps
    22                 Ajout d'un id unique au bloc #defautsubmit_xxx
     11## Fichiers surchargés du plugin Médias
     12Plusieurs fichiers sont surchargés pour régler des problèmes javascripts, ou ajouter des éléments.
     13A terme il faudrait s'en passer.
    2314
    24 - Pipeline complement_objet (fiche d'un objet)
    25   Bouton pour deplacer tous les documents du portfolio vers un album, et inversement
     15- `prive/objets/editer/colonne_documents.html` :
     16ajout des albums et d'un mini menu pour basculer entre les documents et les albums.
     17- `formulaires/inc-upload_document.html` :
     18modifications afin de pouvoir afficher plusieurs fois le formulaire sur une même page.
  • _plugins_/albums/trunk/paquet.xml

    r82783 r83558  
    33        categorie="multimedia"
    44        version="2.3.3"
    5         etat="test"
     5        etat="dev"
    66        compatibilite="[3.0.0;3.0.*]"
    77        logo="prive/themes/spip/images/albums-128.png"
Note: See TracChangeset for help on using the changeset viewer.