WackoWiki : Wacko Documentation / Upload Files

Оглавление документа

1. Description Actions

1.1. upload

1.2. files

2. Syntax of reference to the file

2.1. URL syntax

2.2. Wacko syntax

3. Tuning the installation

3.1. Tuning wakka.config.php

3.2. Script for creating the table in DB

3.3. That it is necessary to guide in the file system

4. Which remained to make

5. To Do

1. Description Actions

1.1. upload

Form for the load of file to this page or into the global space
Invoke: {{Upload [global=1] [maxsize=200] [hide_description=1]}}
Parameters:
- global the flag of the fact that the load will be unconditional into the global space
- maxsize forcedly limits max. the size (must be less than in konfige)
- hide_description not to show text field “description”, there remains only field for the file

1.2. files

Form for the load of file to this page or into the global space
Call: {{Files [param0="PageName" or global=1] [order="time|FILENAME|size|size_desc|ext"] [owner="UserName"] [pictures="1"] [nomark="1"]}}
Parameters:
- the first parameter is the name of the page, for which to derive list it is file. If global=1, then the list of the global space is derived
- order as to order, correspondingly, on the time, name, to size, the size-in-reverse- order, to the expansion
- owner to show the files, shaken only by this user
- pictures for the pictures instead of the references to show pictures themselves something the type of the gallery
Aliase: {{GlobalFiles}}, {{PageFiles}} with the filled first parameter

2. Syntax of reference to the file

2.1. URL syntax

files/fubar.zip the global space
- in this case files is assigned in config and it can be:
- /someotherpath/fubar.zip
WakkaToDo/Upload/files?get=fubar.zip the file, attached to the concrete page
- in this case files is fixed without the revra1t- mode it looks like:
- WakkaToDo/Upload/files&get=fubar.zip

2.2. Wacko syntax

file:fubar.zip – does search for in the global and in the current depository? and file:/fubar.zip – only in the global?
file:!/fubar.zip
file:/WakkaToDo/Upload/fubar.zip

3. Tuning the installation

3.1. Tuning wakka.config.php


                
                    <?php
  "upload"             => true,
  "upload_images_only" => true,
  "upload_max_size"    => 100,
  "upload_max_per_user" => 100,
  "upload_path"           => "files",
  "upload_path_per_page"  => "files/perpage",
?>

upload = false, true, “admins” who can load. Anonymous authors cannot load ever
upload_images_only if is established, then it does not give to load something besides pictures. Pictures are determined with the aid of GD
upload_max_size the maximum permissible size of file, in KB
upload_max_per_user is how much file it can load one user (if it is not established, then as much as desired)
upload_path where are placed the public files
upload_path_per_page where are placed the nepublichnye files, attached to the concrete pages
N.B ensure quotes are removed around true values

3.2. Script for creating the table in DB


                CREATE TABLE r4_upload (

                  id int(11) NOT NULL auto_increment,

                  page_id int(11) NOT NULL default '0',

                  filename varchar(250) NOT NULL default '',

                  description varchar(250) NOT NULL default '',

                  uploaded_dt datetime NOT NULL default '0000-00-00 00:00:00',

                  filesize int(11) NOT NULL default '0',

                  picture_w int(11) NOT NULL default '0',

                  picture_h int(11) NOT NULL default '0',

                  file_ext varchar(10) NOT NULL default '',

                  user varchar(80) NOT NULL default '0',

                  PRIMARY KEY  (id),

                  KEY page_id (page_id,filename),

                  KEY page_id_2 (page_id,uploaded_dt),

                  KEY user_id (user,page_id)

                ) TYPE=MyISAM;

3.3. That it is necessary to guide in the file system

First, it is good in the standard delivery of installyatora to include these two catalogs (see above names) with the the standard of..yutachchess.

Secondly, to both these catalogs it is necessary to give rights to the record. Apparently, this mozhno/nuzhno to make only by hand. A question, must installyator or something check, are established rights?

4. Which remained to make

at catalog images lie two files & this of the pictures, which must be drawn, they reflect two statuses “access it is forbidden” and “file is not found”. This is made pictures in order to ensure correct work and with inklyudemente of the picture somewhere. Well and quip, inklyudement. Br.
it is necessary to alter all places, where is caused Link("file:XXX") and Link("_ file:" ) on something, which must be in the opinion Of kukutsa more adequate
it is necessary to make the link, which would work with all by the Vaca- syntaxes

It thus far repaired hole with the scripts thus :


                
                    <?
         $banned = explode("|", $this->config["upload_banned_exts"]);
         if (in_array(strtolower($ext), $banned))
           $ext = $ext.".txt";
?>

5. To Do

pls. finish this translation, this was only an temporary text for german docu