Autosubmit

fr.eeDumper est livré avec un système d’autosubmit (soumission automatique) vous permettant, en un seul clic, de soumettre vos propres vidéos sur les sites de vos partenaires sans avoir à remplir le moindre formulaire.

• Fonctionnement d’un formulaire de soumission classique :

Pour expliquer simplement le fonctionnement de l’autosubmit, regardons un formulaire simple de soumission de vidéos.

Un formulaire est composé des éléments suivants :

- Un champ “title” pour le titre de la vidéo
- Un champ “description” pour la description de la vidéo
- Un champ “thumb” permettant d’uploader la vidéo
- Un champ “category” permettant de choisir une catégorie pour la vidéo
- Une action “submit.php” qui est la destination du formulaire

Dans ce cas de figure, volontairement, je ne parle pas des formulaires d’authentification pour des raisons de simplicité.

En connaissant tous ces paramètres, il est possible de transmettre toutes ces informations directement au site Internet via un système de soumission automatique. Le tout étant de savoir faire l’association entre le nom des champs sur le site de destination (title, description, …) et les valeurs sur le site local (title = “Bonjour, ceci est un titre”, description = “Ceci est la description”, thumb = “/var/www/monsite.com/htdocs/thumbs/image01.jpg”, etc…).

• Association par fichier XML

Pour réaliser cette association entre “valeurs” et “noms des champs”, eeDumper repose sur un système de description à base de fichiers XML. Ces fichiers sont la carte d’identité des sites sur lesquels vos vidéos sont envoyées.  Ils décrivent  :

- Le fonctionnement de leur formulaire (destination, etc…)
- Le nom des champs utilisés
- La méthode d’ajout d’image (upload ou hyperlien)
- Si le site requiert de passer par un formulaire d’authentification

• 1ère section : Description du formulaire :

<needLogin>1</needLogin>
<uploadThumb>1</uploadThumb>
<loginURL>http://www.lescokines.org/register/</loginURL>
<postURL>http://www.lescokines.org/submit/</postURL>

Le premier champ “needLogin” indique si le site sur lequel nous voulons soumettre notre vidéo dispose d’un formulaire d’authentification : 1 = Oui, 0 = Non.

Le second champ “uploadThumb” indique si le formulaire a besoin d’uploader la thumb (champ file) ou s’il s’agit d’un champ d’URL de thum : 1 = Upload, 0 = URL.

Le troisième champ “loginURL” correspond à l’adresse à laquelle il faut soumettre les infos de login (si needLogin est égal à 1).

Le quatrième champ “postURL” est l’adresse à laquelle il faut soumettre les infos du plug.

• 2nde section : Description du formulaire de login

/* LOGIN Fields names */
<item>
<name>login</name>
<value>login2</value>
<type>loginFieldName</type>
</item>
<item>
<name>password</name>
<value>password2</value>
<type>loginFieldName</type>
</item>
/* LOGIN Optionnal Fields values */
<item>
<name>action</name>
<value>login</value>
<type>loginFieldValue</type>
</item>

Les items de cette section du fichier XML disposent de 3 attributs :

• name : nom de l’attribut
• value : valeur de l’attribut
• type : type du champ
  • loginFieldName : cet item décrit un nom de champ du formulaire
  • loginFieldValue : cet item décrit une valeur pour un champ du formulaire

En résumé, loginFieldName sert à faire l’association entre le formulaire distant et les variables locales (name = valeur locale (à ne pas modifier), value = nom du champ sur le formulaire).
Quant  à lui, loginFieldValue sert à imposer des valeurs dans les champs du formulaire existant (name = nom du champ sur le formulaire, value = valeur à lui affecter).

Dans cet exemple, le premier item indique que le champ correspondant au login s’appelle login2, celui pour le mot de passe s’appelle password2, et nous transmettons la valeur du champ action à login.

• 3ème section : Description du formulaire de soumission de plug

/* SUBMIT Fields names */
<item>
<name>title</name>
<value>title</value>
<type>fieldName</type>
</item>
<item>
<name>description</name>
<value>description</value>
<type>fieldName</type>
</item>
<item>
<name>url</name>
<value>url</value>
<type>fieldName</type>
</item>
<item>
<name>thumb</name>
<value>thumb</value>
<type>fieldName</type>
</item>

/* SUBMIT Optionnal fields value */
<item>
<name>op</name>
<value>submit</value>
<type>fieldValue</type>
</item>
<item>
<name>category</name>
<value>2</value>
<type>fieldValue</type>
</item>

Cette section du formulaire XML fonctionne exactement de la même manière que la précédente. A la différence près que les types deviennent fieldName et fieldValue.

• Les variables utilisables

Voici la liste des variables utilisables dans les items fieldName :

• title
• description
• url
• thumb

• Les fichiers XML

Les fichiers d’autosoumission XML sont situés dans le répertoire suivant :

/admin/autosubmit/

Dans l’admin, un lien vous permet de mettre à jour automatique la liste des fichiers XML de ce répertoire afin d’ajouter ceux des autres webmasters fr.eeDumper (Config -> Autosubmits).