Difference between revisions of "Views.pl"
(New page: == Option avaible for the views config == ''Basic'' id (mandatory) : fields (mandatory): order: ''Standard'' allow_null: hideempty: heading_level: include: subheadings: ''Extra feature''...) |
(→Option avaible for the views config) |
||
Line 13: | Line 13: | ||
''Extra feature'' | ''Extra feature'' | ||
− | noindex | + | citation: |
− | nolink | + | nocount: |
− | + | nohtml: | |
− | + | noindex: | |
− | + | nolink: | |
+ | |||
+ | ''New features'' | ||
+ | ====new_column_at==== | ||
+ | |||
+ | This is an array of integers representing the number of items in a view list before another column is added. For example: | ||
+ | |||
+ | [ 10 ] | ||
+ | |||
+ | This would have one column of values until there were 11, then there would be 2 columns. | ||
+ | |||
+ | [ 10, 10 ] | ||
+ | |||
+ | This would have one column if there were ten or less values, two columns if there were between eleven and twenty (ten + ten) values, and three columns for all other cases. | ||
+ | |||
+ | [ 0, 0 ] | ||
+ | |||
+ | This would always have three columns. | ||
+ | |||
+ | Add one to the number of integers in the array and you get the maximum number of columns. The value of each integer defines the point at which that column becomes full, and more values cause an 'overflow' into the next column. | ||
+ | |||
+ | ====variations==== | ||
+ | |||
+ | This controls the various ways in which a browse view can be subheaded. It consists of a list of strings. Each string is the name of a non-compound metadata field (or the keyword DEFAULT, for an unsubheaded list), optionally followed by a semi-colon and a comma separated list of options. E.G: | ||
+ | |||
+ | variations => [ | ||
+ | "creators_name;first_letter", | ||
+ | "type", | ||
+ | "DEFAULT" | ||
+ | ], | ||
+ | |||
+ | The following options are available: | ||
+ | |||
+ | =====reverse===== | ||
+ | |||
+ | Reverses the order in which the groupings are shown. Default is the ordervalue for that field (usually alphanumeric). Useful for dates as you may want the highest values first. | ||
+ | |||
+ | =====filename===== | ||
+ | |||
+ | Changes the filename of the view variation. The default is the name of the metadata field used, so if two variations use the same metadata field with different options, this is needed. | ||
+ | |||
+ | filename=different_filename | ||
+ | |||
+ | =====first_value===== | ||
+ | |||
+ | If a field is multiple, only use the first value. Otherwise each item will appear once for each value. | ||
+ | |||
+ | =====first_initial===== | ||
+ | |||
+ | If using a name, truncate the given name to the first initial. This will make items like "Les Carr" and "Leslie Carr" appear together. Note it will also make "John Smith" and "Jake Smith" appear together too, showing that you really never can win. | ||
+ | |||
+ | =====first_letter===== | ||
+ | |||
+ | The same as 'truncate=1' | ||
+ | |||
+ | =====truncate===== | ||
+ | |||
+ | Use the first X characters of a value to group by. truncate=4 may be useful for dates as it will group by the first four digits (the year) only. | ||
+ | |||
+ | truncate=4 | ||
+ | |||
+ | =====tags===== | ||
+ | |||
+ | Useful for fields like keywords where values may be separated by commas or semi-colons. The value is split on these two characters ( , and ; ) and a heading is created for each. | ||
+ | |||
+ | =====cloud===== | ||
+ | |||
+ | Creates a tag cloud. Sets jump to 'plain', cloudmax to 200, cloudmin to 80 and no_separator, then resizes the jump-to links according to frequency of use. | ||
+ | |||
+ | =====cloudmax===== | ||
+ | |||
+ | The % size of the largest tag in a tag cloud. | ||
+ | |||
+ | =====cloudmin===== | ||
+ | |||
+ | The % size of the smallest tag in a tag cloud. | ||
+ | |||
+ | =====jump===== | ||
+ | |||
+ | jump=plain | ||
+ | |||
+ | Turns of the 'jump to' text before the list of subheading navigation links. | ||
+ | |||
+ | =====no_seperator (sic)===== | ||
+ | |||
+ | Turns of the separator between each subheading navigation link (by default '|'). | ||
+ | |||
+ | =====string===== | ||
+ | |||
+ | Uses values 'as is'. No ordervalues, no phrases. |
Revision as of 08:46, 3 July 2008
Contents
Option avaible for the views config
Basic id (mandatory) : fields (mandatory): order:
Standard allow_null: hideempty: heading_level: include: subheadings:
Extra feature citation: nocount: nohtml: noindex: nolink:
New features
new_column_at
This is an array of integers representing the number of items in a view list before another column is added. For example:
[ 10 ]
This would have one column of values until there were 11, then there would be 2 columns.
[ 10, 10 ]
This would have one column if there were ten or less values, two columns if there were between eleven and twenty (ten + ten) values, and three columns for all other cases.
[ 0, 0 ]
This would always have three columns.
Add one to the number of integers in the array and you get the maximum number of columns. The value of each integer defines the point at which that column becomes full, and more values cause an 'overflow' into the next column.
variations
This controls the various ways in which a browse view can be subheaded. It consists of a list of strings. Each string is the name of a non-compound metadata field (or the keyword DEFAULT, for an unsubheaded list), optionally followed by a semi-colon and a comma separated list of options. E.G:
variations => [ "creators_name;first_letter", "type", "DEFAULT" ],
The following options are available:
reverse
Reverses the order in which the groupings are shown. Default is the ordervalue for that field (usually alphanumeric). Useful for dates as you may want the highest values first.
filename
Changes the filename of the view variation. The default is the name of the metadata field used, so if two variations use the same metadata field with different options, this is needed.
filename=different_filename
first_value
If a field is multiple, only use the first value. Otherwise each item will appear once for each value.
first_initial
If using a name, truncate the given name to the first initial. This will make items like "Les Carr" and "Leslie Carr" appear together. Note it will also make "John Smith" and "Jake Smith" appear together too, showing that you really never can win.
first_letter
The same as 'truncate=1'
truncate
Use the first X characters of a value to group by. truncate=4 may be useful for dates as it will group by the first four digits (the year) only.
truncate=4
tags
Useful for fields like keywords where values may be separated by commas or semi-colons. The value is split on these two characters ( , and ; ) and a heading is created for each.
cloud
Creates a tag cloud. Sets jump to 'plain', cloudmax to 200, cloudmin to 80 and no_separator, then resizes the jump-to links according to frequency of use.
cloudmax
The % size of the largest tag in a tag cloud.
cloudmin
The % size of the smallest tag in a tag cloud.
jump
jump=plain
Turns of the 'jump to' text before the list of subheading navigation links.
no_seperator (sic)
Turns of the separator between each subheading navigation link (by default '|').
string
Uses values 'as is'. No ordervalues, no phrases.