#FORMULAIRE_JOINDRE_DOCUMENT{new,#ENV{id_objet},#ENV{objet}} sert à téléverser un document et à l’associer à un objet SPIP.
Par exemple, pour téléverser un document et l’associer à un article :
<div class="ajax">
#FORMULAIRE_JOINDRE_DOCUMENT{new,#ENV{id_article},'article'}
</div>
On peut aussi téléverser des documents depuis l’espace public sans les rattacher à un objet :
<div class="ajax">
#FORMULAIRE_JOINDRE_DOCUMENT
</div>
Par défaut, le formulaire sans argument #FORMULAIRE_JOINDRE_DOCUMENT est visible pour tout le monde, y compris les visiteurs non authentifiés, mais la balise avec arguments (pour rattacher le document à un article par exemple), n’est visible que des administrateurs.
Compléments d’information
Un 4eme argument peut être passé à la balise : il indique le mode d’association du document à l’objet. Les valeurs acceptées sont auto (par défaut) ou choix, document, image, vignette, logoon, logooff...
On pourra utiliser le rechargement télécommandé de blocs ajax pour visualiser les documents dès qu’un nouveau téléversement est effectué : s’il existe un bloc ajax nommé documents, la validation du formulaire entraîne en effet son rechargement.