Difference between revisions of "AdminLists"
Tokyoahead (talk | contribs) |
Tokyoahead (talk | contribs) |
||
Line 7: | Line 7: | ||
== Simple Lists == | == Simple Lists == | ||
+ | === The header === | ||
The first element of a list is the header, the line where you can read what the information below represents. To define those use an array, each of the elements of the array define one column: | The first element of a list is the header, the line where you can read what the information below represents. To define those use an array, each of the elements of the array define one column: | ||
Line 33: | Line 34: | ||
<tr><td>field_class</td><td>The CSS class that should be assigned to the data fields below</td><td>string</td><td>No</td></tr> | <tr><td>field_class</td><td>The CSS class that should be assigned to the data fields below</td><td>string</td><td>No</td></tr> | ||
</table> | </table> | ||
− | + | === Text fields & Settings === | |
Then, you need a text-array, defining some other details of the table: | Then, you need a text-array, defining some other details of the table: | ||
Line 53: | Line 54: | ||
</table> | </table> | ||
+ | === The Menu === | ||
In case the $text_arr stats has_menu = true, you need to give the following array for the menu details: | In case the $text_arr stats has_menu = true, you need to give the following array for the menu details: | ||
<pre> | <pre> | ||
Line 69: | Line 71: | ||
This pretty straight-forward Array gives a text to display and a url to link for each desired menu item. | This pretty straight-forward Array gives a text to display and a url to link for each desired menu item. | ||
The next array is called $form_arr and is optional: | The next array is called $form_arr and is optional: | ||
− | + | === Aditional Form Fields === | |
<pre> | <pre> | ||
$form_arr = array( | $form_arr = array( | ||
Line 76: | Line 78: | ||
); | ); | ||
</pre> | </pre> | ||
− | This array allows you to display additional information above and below the table, specifically for form elements such as extra buttons etc. The tables have a form around them. Please take a look at the templates under /layout/professional/admin/lists/ to understand what you can do with them. Those forms are used for example in moderation.php | + | This optional array allows you to display additional information above and below the table, specifically for form elements such as extra buttons etc. The tables have a form around them. Please take a look at the templates under /layout/professional/admin/lists/ to understand what you can do with them. Those forms are used for example in moderation.php |
+ | |||
+ | === The Data === | ||
+ | The actual data is given through an array that holds one element for each cell. | ||
+ | <pre> | ||
+ | $data_arr = array(); | ||
+ | $data_arr[] = array( | ||
+ | 'title' => $LANG10[2], | ||
+ | 'stats' => COM_NumberFormat ($totalhits) | ||
+ | ); | ||
+ | </pre> | ||
+ | This would create one line in the table. You can extend the array as you whish, but each field must match the fields given as 'field' the $header_arr(). |
Revision as of 10:12, 1 March 2007
Contents
Introduction
Geeklog 1.4 has an engine to create tables/lists from data. This engine can be used to make sure that all tabular information looks similar all over the site. It is also helpful to reduce the amount of code that has to be written for a table, including template files.
To use this function, you have to choose between two main differences: Simple & Complex lists. The main difference is that the simple lists need an array of data and the complex lists need an SQL string of data. So if you do not have your data in a database table, you will need to use a simple list. Also, the simple lists only can be displayed several times on a page (such as used on the moderation and statistics screens).
Generally it is recommended to take any of the existing lists and changing the details. This makes sure that you use the required set of data for a complete table.
Simple Lists
The header
The first element of a list is the header, the line where you can read what the information below represents. To define those use an array, each of the elements of the array define one column:
$header_arr = array( array( // Column 1 'text' => $LANG10[1], 'field' => 'title', 'width' => '90%', 'header_class' => 'stats-header-title' ), array( // Column 2 'text' => "", 'field' => 'stats', 'header_class' => 'stats-header-count', 'field_class' => 'stats-list-count' ), );
You can see that you need to create a multi-dimensional array with several fields, most of which are optional. Required are the first two.
Field/Array Name | Content | Data Type | Required |
---|---|---|---|
text | The text that the user sees on top of the column | string | Yes |
field | The field in the data-array that is used to show the data | string | Yes |
header_class | The CSS class that should be assigned to the header field | string | No |
field_class | The CSS class that should be assigned to the data fields below | string | No |
Text fields & Settings
Then, you need a text-array, defining some other details of the table:
$text_arr = array( 'has_menu' => false, 'title' => $LANG10[1], );
Field/Array Name | Content | Data Type | Required |
---|---|---|---|
has_menu | If set to true | boolean | Yes |
title | The title of the table. Since the table will be in a block, the block needs a title | string | Yes |
help_url | The url that shows help for the block | string | No |
form_url | The form used in case the menu is there | string | if has_menu=true |
icon</th><td>An Icon to be displayed | <td>string</th><td>No</td>