X-Git-Url: http://olivier.miskin.fr/git/?a=blobdiff_plain;ds=sidebyside;f=README.rst;fp=README.rst;h=f1c71de2b4a6497ea81159a87a4a685f7c87818c;hb=9154d5356b9eafd04c61fa1e4cf16b684cb13bda;hp=0000000000000000000000000000000000000000;hpb=7e32fd1e158dc1a3078b9a46542aee3b81f8f391;p=spip_souscriptions.git
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..f1c71de
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,64 @@
+==========================================
+Souscription : dons et adhésions avec SPIP
+==========================================
+
+Présentation du *plugin*
+========================
+
+Souscription est un *plugin* permettant de mettre en place, sur un
+site fonctionnant sous `SPIP `, des campagnes
+d'adhésions ou de dons. Le paiement est délégué au *plugin* `Bank
+`, qui prend en charge différentes
+plateforme de paiement en ligne (chèque, PayBox, PayPal, virement,
+etc.).
+
+Ce *plugin* a été développé pour les besoins d'`Attac France
+` et de `Basta !
+`.
+
+Installation
+============
+
+Le *plugin* étant encore largement en développement (bien qu'utilisé
+en production par Attac France), il n'est pas installable directement
+depuis l'interface de gestion des *plugins* de SPIP.
+
+Pour installer le *plugin*, il faut récupérer l'archive de la
+`dernière version
+` publiée sur
+GitHub ou dupliquer le dépôt Git :
+
+ $ git clone https://github.com/otetard/spip_souscription souscription
+
+Il faut aussi récupérer le *plugin* `Bank
+`, hébergé lui aussi sur GitHub :
+
+ $ git clone https://github.com/nursit/bank
+
+Les deux répertoires ``souscription/`` et ``bank/`` doivent ensuite
+être placés dans votre répertoire ``plugins/`` de votre installation
+SPIP.
+
+Enfin, vous pouvez activer le *plugin* depuis l'interface de gestion
+des *plugins* de SPIP, ce qui permettra de télécharger les autres
+dépendances automatiquement.
+
+Configuration
+=============
+
+Il est possible de configurer le *plugin* (définition des montants
+proposés pour l'adhésion et/ou le dons). Pour cela, il faut se rendre
+dans le menu « Configuration » puis « Souscriptions ».
+
+Première utilisation
+====================
+
+La première étape pour utiliser le *plugin* souscription est de mettre
+en place une campagne, d'adhésions ou de dons. Une campagne peut avoir
+des objectifs et il est éventuellement possible de définir des
+montants spécifiques.
+
+Pour afficher le formulaire d'adhésion, il faut ensuite ajouter le
+code suivant dans un article (en adaptant le numéro de la campagne) :
+
+