1 | <div style="text-align:left;"> |
---|
2 | <h2>Extended Description</h2> |
---|
3 | |
---|
4 | <h3>Multilanguage descriptions</h3> |
---|
5 | |
---|
6 | <p>Multilanguage descriptions are placed between [lang=xx] and [/lang] tags, where xx is the language code (for example en, es, fr). There are also 2 special languages : [lang=default] and [lang=all]</p> |
---|
7 | |
---|
8 | <ul> |
---|
9 | <li><b>Example</b>:<br> |
---|
10 | <code>[lang=default] default description [/lang]<br> |
---|
11 | [lang=en] description in english [/lang]<br> |
---|
12 | [lang=de] deutsche Beschreibung [/lang]</code> |
---|
13 | </li> |
---|
14 | </ul> |
---|
15 | |
---|
16 | <p>The default description will be used if the description is not available in the connected user selected language. |
---|
17 | If [lang=default] does not exists, anything outside the [lang] tags will be considered as the default description.</p> |
---|
18 | |
---|
19 | <p><u>Special language <i>all</i></u>: anything inside [lang=all] will be included in the description, whatever the connected user defined language is. |
---|
20 | This is mainly useful to include HTML/JavaScript code inside a description.</p> |
---|
21 | |
---|
22 | <h3>Extended descriptions</h3> |
---|
23 | |
---|
24 | <p>Extended description tags make it possible to have a short description for the album outside the album, |
---|
25 | a longer description for the album inside the album page, |
---|
26 | or even 2 distinct descriptions inside the album page.</p> |
---|
27 | |
---|
28 | <p>tag <!--more--> adds text to the short description.<br> |
---|
29 | tag <!--complete--> lets the user have 2 distinct descriptions.<br> |
---|
30 | tag <!--up-down--> lets the user have a top and a bottom description.</p> |
---|
31 | |
---|
32 | <ul> |
---|
33 | <li><b><!--more--></b></li> |
---|
34 | </ul> |
---|
35 | <code>short description <!--more--> long description</code> |
---|
36 | <p>Only the short description is displayed outside the album. On the album page, you will see short description + long description.</p> |
---|
37 | |
---|
38 | <ul> |
---|
39 | <li><b><!--complete--></b></li> |
---|
40 | </ul> |
---|
41 | <code>short description <!--complete--> long description</code> |
---|
42 | <p>Only the short description is displayed outside the album. On the album page, you will only see the long description, so you have 2 distinct descriptions.</p> |
---|
43 | |
---|
44 | <ul> |
---|
45 | <li><b><!--up-down--></b></li> |
---|
46 | </ul> |
---|
47 | <code>top description <!--up-down--> bottom description</code> |
---|
48 | <p>Only the top description is displayed outside the album. On the album page, the top description is displayed above the thumbnails, the bottom description is displayed below the thumbnails.</p> |
---|
49 | |
---|
50 | <h3>Insert an album or a photo</h3> |
---|
51 | |
---|
52 | <ul> |
---|
53 | <li><b>[cat=xx]</b></li> |
---|
54 | </ul> |
---|
55 | <p>This tag inserts an album in the description, where xx is the album identifier.</p> |
---|
56 | |
---|
57 | <ul> |
---|
58 | <li><b>[photo id=xx album=yy size=M html=yes link=yes]</b></li> |
---|
59 | </ul> |
---|
60 | <p>This tag allows you to insert one picture of any size you want, with:<br><br> |
---|
61 | - <code>id</code> the photo identifier<br> |
---|
62 | - <code>album</code> (optional) the parent album identifier<br> |
---|
63 | - <code>size</code> (optional) the size of the photo, from <i>{SQ, TH, XXS, XS, S, M, L, XL, XXL}</i><br> |
---|
64 | - <code>html</code> (optional) if set to <i>no</i> the tag only returns the URL of the photo, without HTML<br> |
---|
65 | - <code>link</code> (optional) if set to <i>yes</i> the photo is wrapped into a link to the picture page</p> |
---|
66 | |
---|
67 | <ul> |
---|
68 | <li><b>[random album=yy size=M html=yes link=yes]</b></li> |
---|
69 | </ul> |
---|
70 | <p>Same thing as above, except that the photo is chosen randomly from <code>album</code></p> |
---|
71 | |
---|
72 | <ul> |
---|
73 | <li><b>[slider album=xx nb_images=10 random=no list=aa,bb,cc size=M speed=3 title=no effect=fade arrows=yes control=yes elastic=no]</b></li> |
---|
74 | </ul> |
---|
75 | <p>This tag allows to insert a slideshow (NivoSlider). (you must set <code>album</code> OR <code>list</code>):<br><br> |
---|
76 | - <code>album</code> (optional) source album<br> |
---|
77 | - <code>nb_images</code> (optional) max number of photos to display in the slideshow<br> |
---|
78 | - <code>random</code> (optional) choose photos randomly in the album<br> |
---|
79 | - <code>list</code> (optional) a list of photos ids separated by a comma<br> |
---|
80 | - <code>size</code> (optional) the size of the photos, from <i>{SQ, TH, XXS, XS, S, M, L, XL, XXL}</i><br> |
---|
81 | - <code>speed</code> (optional) the slideshow speed (in seconds)<br> |
---|
82 | - <code>title</code> (optional) display photo title<br> |
---|
83 | - <code>effect</code> (optional) transition effect (see <a href="http://nivo.dev7studios.com/support/jquery-plugin-usage/">NivoSlider doc</a>)<br> |
---|
84 | - <code>arrows</code> (optional) display navigation arrows<br> |
---|
85 | - <code>control</code> (optional) display navigation controls<br> |
---|
86 | - <code>elastic</code> (optional) adapt slideshow size to each photo</p> |
---|
87 | |
---|
88 | |
---|
89 | <h3>Hide an album</h3> |
---|
90 | |
---|
91 | <p>Use tag <b><!--hidden--></b> in the album name:<br> |
---|
92 | <br> |
---|
93 | - it won't be displayed in the parent album<br> |
---|
94 | - it remains visible in the album menu</p> |
---|
95 | |
---|
96 | <h3>Hide an album from the menu</h3> |
---|
97 | |
---|
98 | <p>Use tag <b><!--mb-hidden--></b> in the album name:<br> |
---|
99 | <br> |
---|
100 | - it won't be displayed in the album menu<br> |
---|
101 | - it remains visible in the parent album</p> |
---|
102 | |
---|
103 | <h3>Hide a photo</h3> |
---|
104 | |
---|
105 | <p>Use tag <b><!--hidden--></b> in the photo name:<br> |
---|
106 | <br> |
---|
107 | - it won't be displayed on the thumbnails page<br> |
---|
108 | - it remains visible inside the album</p> |
---|
109 | |
---|
110 | <h3>Redirected album</h3> |
---|
111 | |
---|
112 | <ul> |
---|
113 | <li><b>[redirect http://piwigo.org]</b></li> |
---|
114 | </ul> |
---|
115 | <p>Insert this tag into a album description to redirect it to the URL of your choice.</p> |
---|
116 | |
---|
117 | <ul> |
---|
118 | <li><b>[redirect img=xx]</b></li> |
---|
119 | </ul> |
---|
120 | <p>Redirect to a photo of your gallery where xx is the photo identifier; you can add the album identifier next to the photo identifier: <code>xx.ccc</code>.</p> |
---|
121 | |
---|
122 | <ul> |
---|
123 | <li><b>[redirect cat=xx]</b></li> |
---|
124 | </ul> |
---|
125 | <p>Redirect to a album of your gallery where xx the album identifier.</p> |
---|
126 | |
---|
127 | <ul> |
---|
128 | <li><b>[redirect search=xx]</b></li> |
---|
129 | </ul> |
---|
130 | <p>Redirect to a search page of your gallery where xx is the search identifier.</p> |
---|
131 | </div> |
---|