Browse Source

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.
svn/attic/branches/v3/86876
tcharlss@hotmail.fr 8 years ago
parent
commit
477ba03f03
  1. 5
      .gitattributes
  2. 76
      MAJ.md
  3. 27
      REGLES DE COMMIT.TXT
  4. 53
      REGLES DE COMMIT.md
  5. 18
      TODO.md
  6. 25
      TODO.txt
  7. 2
      paquet.xml

5
.gitattributes vendored

@ -1,6 +1,7 @@
* text=auto !eol
/REGLES[!!-~]DE[!!-~]COMMIT.TXT -text
/TODO.txt -text
/MAJ.md -text
/REGLES[!!-~]DE[!!-~]COMMIT.md -text
/TODO.md -text
action/associer_album.php -text
action/dissocier_album.php -text
action/editer_liens_album.php -text

76
MAJ.md

@ -0,0 +1,76 @@
Plugin Albums : mises à jour
============================
Notes sur certaines mises-à-jour, notamment sur les ruptures de compatibilité et comment vivre avec.
## V3.0
### Suppression du critère {contenu}
A la place, il suffit de faire des boucles avec une jointure : `<BOUCLE_x(ALBUMS documents)>`.
Du coup, on peut employer le critère {media} pour le même résultat, ainsi que d'autres critère des documents, et on peut utiliser des opérateurs.
- `{media = x}` remplace `{contenu x}` : albums contenant un type de media.
- `{extension == x|y}` : albums contenant les extensions x ou y.
- `{id_document != x}` : albums ne contenant pas un document donné.
- `{fichier LIKE %x%}` : albums contenant un fichier correspondant au terme x.
### Suppression de fonctions obsolètes
Les fonctions suivantes étaient utilisées dans certains squelettes de l'espace privé. Elles renvoyaient directement des tags html (bouh!) et étaient d'une utilité limitée.
- `album_determiner_contenu()`
- `filtre_album_contenu()`
- `filtre_album_liaison()`
### Actions
- ajout : `vider_album`
- ajout : `supprimer_album`
- suppression : `editer_liens_album`
### Formulaire édition
- Le titre n'est plus obligatoire, afin de pouvoir créer des albums rapidement.
- Plus de `&id_album=x` ajouté à l'URL après redirection.
### Formulaire d'ajout d'album à un objet
Nouveau formulaire `ajouter_album` qui permet d'ajouter un album à un objet en 1 étape : c'est un mélange de `editer_album` + `joindre_document`.
On peut soit créer et remplir un nouvel album, soit en choisir un existant.
### Formulaire pour générer un balise `<album>`
Nouveau formulaire inspiré du plugin «Insérer modèles» pour personnaliser une balise `<album>` à insérer dans un texte.
Les fichiers yaml des modèles sont compatibles.
### Formulaire de déplacements de documents
Révision du code JS. On ne l'affiche que si on est autorisé.
### Albums liés en mode édition
On affiche les albums également en mode édition d'un objet, de la même façon que les documents.
On peut ajouter à un album à un objet en cours de création, en utilisant le même hack que le plugin «Médias» (identifiant négatif temporaire).
### Modèles
Révision des modèles et de leurs paramètres. On part sur l'idée d'avoir des modèles minimalistes de base.
Par défaut, on n'affiche que le strict minimum : pas de titre, ni de descriptif, ni rien. Pour étoffer l'affichage, il faut passer des paramètres.
Révision du markup pour avoir des `<figure>` conforme, cf. [l'exemple de tiny typo](http://tinytypo.tetue.net/tinytypo.html#album)
Les modèles sont rendus compatibles avec la syntaxe de la version 1 : `<album|id_article=x>` et `<album|id=1,2,3>`
### Autorisations
- Renommage de `associeralbum` en `album_associer`
- Ajout de : `album_dissocier`, `ajouteralbum`, `deplacerdocumentsalbums`
- Modification (pour la bonne cause) de : `album_modifier` et `album_supprimer`
### Boîte latérale «utilisations»
Déplacement du squelette de «navigation» vers «extra». On ne l'affiche pas en mode édition, + pétouilles.
### Configuration : téléversement des documents.
Message d'erreur si le téléversement n'est pas activé pour les albums, dans la configuration des documents et celle des albums.
Cf. pipeline `formulaire_traiter`.
### Compagnons
Ils sont de retours.
### Albumothèque
Refonte de l'interface : filtres latéraux.
### Chaînes de langue
Suppression de chaînes obsolètes, ajout de nouvelles.

27
REGLES DE COMMIT.TXT

@ -1,27 +0,0 @@
==================================
Plugin Albums 2 : règles de commit
==================================
Pour faire simple : tout le monde est encouragé à commiter dans la mesure ou ça ne bouleverse pas l'utilisation ou l'apparence du plugin.
Si c'est le cas, rendez-vous sur la liste de discussion spip-zone pour en discuter.
==========
Squelettes
==========
En cas d'ajout de nouveaux squelettes, pensez aux autres contributeurs.
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.
Les commentaires dans la page sont vivement encouragés.
=======
Modèles
=======
Le plugin n'a pas vocation à fournir nombre de variantes différentes.
C'est aux autres plugins qui reposent sur les documents de proposer des variantes de modèles Album.
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.
De plus, les styles publics des 2 modèles doivent être le plus minimal possible, afin d'être facilement surchargeables.
========================
Styles de l'espace privé
========================
On essaie de rester sobre, et de respecter tant que faire se peut la charte de SPIP.
Pour info, une charte est dispo page ?exec=charte après installation du plugin 'développement'.

53
REGLES DE COMMIT.md

@ -0,0 +1,53 @@
Plugin Albums : règles de commit
================================
Tout le monde est encouragé à commiter dans la mesure ou ça ne bouleverse pas l'utilisation ou l'apparence du plugin.
Si c'est le cas, rendez-vous sur la liste de discussion spip-zone ou sur IRC pour en discuter.
## Squelettes
En cas d'ajout de squelettes ou de code php, pensez aux autres contributeurs : commentez !
Chaque squelette devrait commencer par 1 à 3 commentaires expliquant certains points :
- la description du squelette.
- les squelettes utilisés, et ceux où il est inclus.
- les paramètres éventuels.
Exemple complet :
[(#REM)
Description du squelette
][(#REM)
Utilise :
inclure/noisette.html
Inclus dans :
prive/squelettes/contenu/truc.html
][(#REM)
Paramètres (*obligatoire):
*param1 explication param1
param2 explication param2
]
## Modèles
Le plugin ne fournit que 2 variantes pour le modèle `<album>` : une vue «vignettes» par défaut et une variante «liste».
Ces 2 modèles sont minimalistes par choix : ils ont vocation à être surchargés.
On 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.
### Ajouter des modèles
Les plugins qui se servent des albums peuvent ajouter des variantes du modèle `<album>`, pour des diaporamas, des playlists etc.
Le principe du plugin «Insérer modèles» est repris.
A chaque variante du modèle doit correspondre un fichier yaml contenant les saisies des options du modèle.
Ce fichier yaml sert au formulaire qui permet de générer une balise `<album>` à insérer dans le texte, en mode édition.
Par exemple, pour ajouter une variante «diaporama», il faut :
- un fichier `album_diaporama.html`
- un fichier `album_diaporama.yaml`. Il y a 4 saisies obligatoires : `modele`, `id_modele`, `id_album` et `variante`. Voir pour exemple `album_liste.yaml`

18
TODO.md

@ -0,0 +1,18 @@
Plugin Albums : todo
====================
Liste de choses à faire, sans version particulière ciblée.
## Liste des albums liés
- Bouton pour dépacer les documents d'un album dans le portfolio.
- Bouton pour déplacer les documents du portfolio dans un nouvel album.
## Fichiers surchargés du plugin Médias
Plusieurs fichiers sont surchargés pour régler des problèmes javascripts, ou ajouter des éléments.
A terme il faudrait s'en passer.
- `prive/objets/editer/colonne_documents.html` :
ajout des albums et d'un mini menu pour basculer entre les documents et les albums.
- `formulaires/inc-upload_document.html` :
modifications afin de pouvoir afficher plusieurs fois le formulaire sur une même page.

25
TODO.txt

@ -1,25 +0,0 @@
===========
v 2.2 / 2.3
===========
- Modèles
reprendre les fonctionnement de la v1 qui surcharge le portfolio pour y inclure les albums ?
- Pipeline affiche_gauche (édition d'un objet)
Afficher le liste des albums un peu a la façon du plugin 'médias', avec une touche du plugin 'insérer modèles'.
-> Pouvoir créer ou associer un album
-> générer les balises en fonction des variantes de modèles dispo, et insertion dans le texte automatique ou au double clic
- Fichiers surchargés du plugin medias :
Plusieurs fichiers sont surchargés à cause de pb javascripts, à terme il faudrait s'en passer.
* prive/squelettes/inclure/portfolio-documents (Modif incluse à partir de SPIP 3.06)
pb javascript quand plusieurs portfolios sont affichés en même temps.
Ajout d'un id unique aux blocs #portfolios, #illustrations, #documents et #portfolio
* formulaires/inc-upload_documents.html
pb javascript quand plusieurs formulaires sont affichés en même temps
Ajout d'un id unique au bloc #defautsubmit_xxx
- Pipeline complement_objet (fiche d'un objet)
Bouton pour deplacer tous les documents du portfolio vers un album, et inversement

2
paquet.xml

@ -2,7 +2,7 @@
prefix="albums"
categorie="multimedia"
version="2.3.3"
etat="test"
etat="dev"
compatibilite="[3.0.0;3.0.*]"
logo="prive/themes/spip/images/albums-128.png"
schema="0.0.3"

Loading…
Cancel
Save