Sujet de cette page

Ce que fait cette action :

• Elle permet de téléverser un fichier sur le site, dans un sous-répertoire d'un répertoire défini pour reçevoir les téléversements (upload). Le sous-répertoire a pour nom le nom de la page d'ou à lieu l'attachement. Le cas ou le safe_mode de php est activé (exemple sur Free.fr) est traité et tous les fichiers téléversés seront dans même répertoire mais leur nom sera préfixé avec le nom de la page d'où a eu lieu le téléversement.
• Si le fichier attaché est une image, elle est affichée dans la page. Cette image peut être sensible, les liens possibles pour une image sensible sont le nom d'une page WikiNi, un lien interwiki et un URL "normal".
• Si le fichier attaché n'est pas une image, alors il est disponible en téléchargement. Un gestionnaire de téléchargement se charge d'empêcher l'exécution de scripts php ou autre sur le serveur.
• Il est possible de supprimer une fichier attaché. fonction supprimée avec la gestion de version des fichiers
• Les fichiers téléversés sont versionnés, il n'y a donc plus la possibilité de supprimer un fichier depuis l'action {{attach}}

Syntaxe

• file ou attachfile: nom du fichier tel qu'il sera sur le serveur. Les espaces sont remplacés par des "_". (OBLIGATOIRE)
• desc ou attachdesc: description du fichier. C'est le texte qui sera affiché comme lien vers le fichier ou dans l'attribut alt de la balise <img>. Ce paramètre est obligatoire pour les images pour être conforme au XHTML.
• delete ou attachdelete: Si ce paramètre est non vide alors le fichier sera effacé sur le serveur. Le fichier n'est pas réellement supprimé mais simplement renommé. Pour le récupérer, il faudra que l'administrateur du site renomme le fichier correctement via FTP ou autre moyen. fonction supprimée avec la gestion de version des fichiers
• link ou attachlink: URL de lien pour une image sensible. le lien peut être un nom de page WikiNi, un lien interwiki ou une adresse http. Ce paramètre est ignoré si le fichier n'est pas une image.
• class: indique le nom de la ou les classes de style à utiliser pour afficher l'image. les noms des classes sont séparés par un espace.

Exemples

• Attacher un fichier archive:
• {{attach file="archive.zip"}}
• Attacher un fichier archive avec une description
• {{attach file="archive.zip" desc="Code source de l'application"}}
• Supprimer un fichier:
• {{attach file="archive.zip" delete="y"}}
• Afficher une image:
• {{attach file="image.png" desc="voici une image"}}
• Afficher une image sensible:
• {{attach file="image.png" desc="voici une image" link="PagePrincipale"}} {{attach file="image.png" desc="voici une image" link="WikiNi:PagePrincipale"}} {{attach file="image.png" desc="voici une image" link="http://www.wikini.net"}}
• Afficher une image collé sur le bord droit et sans contour:
• {{attach file="image.png" desc="voici une image" class="right noborder"}}

Gestionnaire des fichiers attachés

1. Copiez le fichier attach.php dans le répertoire des actions (/actions)
2. Copiez le fichier attach.class.php dans le répertoire des actions (/actions)
3. Copiez le fichier attachfm.php dans le repertoire des actions (/actions)
4. Copiez le fichier filemanager.php dans le répertoire des handlers (/handlers/page)
5. Copiez le fichier upload.php dans le répertoire des handlers (/handlers/page)
6. Copiez le fichier download.php dans le répertoire des handlers (/handlers/page)
7. Créez le répertoire racine des uploads sur le site du wiki. Si le SAFE_MODE de PHP est activé, vous devez créer vous même ce répertoire et autoriser l'écriture dans ce répertoire pour l'utilisateur et le groupe.
8. Ouvrez le fichier wakka.config.php et ajoutez la configuration de l'action.
   • Tous les paramètres de configuration ont une valeur par défaut.
   • Le configuration par défaut est:

1. Ajoutez la définition des classe CSS à utiliser pour les images. Le nom de la classe CSS doit commencer par .attach_. Voici quelques exemples de classe:

1. Pour configurer l'aspect du gestionnnaire de fichier utiliser les classes de style .tableFM , tableFMCol1 et tableFMCol2. La classe tableFM est appliquée au tableau affichant les fichiers. Le tableau utilise les balises <THEAD>, <TFOOT> et <TBODY> conformes au HTML4.

.tableFM {border: thin solid Black; width: 100%;  }
.tableFM THEAD { background-color: Silver; font-weight: bold; text-align: center;   }
.tableFM TFOOT { background-color: Silver; font-weight: bold; text-align: left;   }
.tableFM TBODY TR { text-align: center;  }
.tableFMCol1 { background-color: Aqua; }
.tableFMCol2 { background-color: Yellow; }

Limitation

• Euh... Tu veux rire ?! Il faut trouver une solution dans ton script car c'est une contrainte parfois tout bonnement innacceptable ! -- ProgFou
  • Ben non, je ris pas. En plus j'ai pas le temps de le faire en ce moment donc ... si tu es volontaire pour corriger ce problème "innacceptable"... --GarfieldFr
  • Je modère mon "innacceptable" : je veux dire par là que quand le design t'impose de faire de la ré-écriture d'URL (= pas le choix), c'est dommage de se priver de ton action juste parce qu'elle ne supporte pas la ré-écriture d'URL... Je ne l'avais pas encore installé sur mon site, mais du coup je suis déjà certain que ça ne fonctionnera pas... :-( Je serais bien volontaire pour participer là dessus mais, hélas, le temps me manque en ce moment et ce n'est pas (encore) dans mes priorités... Peut-être que je m'y mettrai quand on m'imposera d'avoir des attachements sur mes pages... ;-) Ceci dit, mon "innacceptable" ne m'empêche pas de reconnaître du bon boulo : le tiens ! -- ProgFou
    • J'avais bien compris et tu as tout à fait raison d'indiquer que c'est dommage que ca ne marche pas avec une redirection d'URL. Il va donc falloir que je trouve comment configurer la redirection d'URL et comment l'utiliser dans attach. Mais c'est pas pour tout de suite... si il y a des volontaires... --GarfieldFr

Mode Réécriture d'URL

Astuces

• "update_symbole" => '<img src="images/update.gif" border="none"/>',
• "fmDelete_symbole" => '<img src="images/delete.gif" border="none"/>',
• "fmRestore_symbole" => '<img src="images/restaure.gif" border="none"/>',
• "fmTrash_symbole" => '<img src="images/corbeill.gif" border="none"/>');

Strona

Download

Witryna

• La dernière version est TOUJOURS sur la page http://codedb.delphicenter.com/wikiAttach/wakka.php?wiki=PagePrincipale et la date est indiquée sur la même page. Mais en effet, dans la prochaine version (si il y en a une) je mettrais un tag de version dans les commentaires. --GarfieldFr