1 <?xml version="1.0" encoding="UTF-8" ?>
3 This template provides meta data for listing nickname-change history entries.
5 @author Roland Haeder <webmaster@mxchange.org>
7 @copyright (c) 2003 - 2009 by Roland Haeder
8 @copyright (c) 2009 - 2011 by Mailer Developer Team
9 @license GNU GPL 2.0 or any newer version
10 @link http://mxchange.org
12 This program is free software; you can redistribute it and/or modify
13 it under the terms of the GNU General Public License as published by
14 the Free Software Foundation; either version 2 of the License, or
15 (at your option) any later version.
17 This program is distributed in the hope that it will be useful,
18 but WITHOUT ANY WARRANTY; without even the implied warranty of
19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 GNU General Public License for more details.
22 You should have received a copy of the GNU General Public License
23 along with this program; if not, write to the Free Software
24 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,
29 Call-back function, the extracted data from this XML will then be re-read
30 from that function. The most common function this XML uses is
31 doGenericListEntries() so mostly you can leave this alone unless you have JOINs.
33 <callback-function type="string" value="doGenericListEntries" />
35 Now we need information which template should be loaded and which functions
36 shall be called back. So lets start with the main list template. This mostly
37 requires no call-back function.
39 <list-template type="string" value="admin_list_nickname_history" />
41 The template for all rows, mostly this name has a '_row' suffix and again,
42 no call-back function is usually required.
44 <list-row-template type="string" value="admin_list_nickname_history_row" />
46 Message id to display if no entry could be found
48 <no-entry-found-message type="string" value="ADMIN_LIST_NICKNAME_HISTORY_404" />
50 The table(s) we shall grab the data from, all as list.
54 A single table entry, with alias and without the configurable
55 _MYSQL_PREFIX. You can specify the table's name or alias later on.
57 <data-table type="string" alias="" value="history" />
59 Columns to perform the SELECT statement on, with alias and name plus which table.
61 <select-data-from-list>
63 A single entry with table name (can be left empty), value (must
64 always be set), alias (again can be left empty) and SQL function
65 (can also be left empty) which shall be applied on the column.
67 <select-data-from-list-entry type="string" table="" value="history_id" alias="" function="" />
68 <select-data-from-list-entry type="string" table="" value="history_userid" alias="" function="" />
69 <select-data-from-list-entry type="string" table="" value="history_value" alias="" function="" />
70 <select-data-from-list-entry type="string" table="" value="history_added" alias="history_added" function="UNIX_TIMESTAMP" />
71 <select-data-from-list-entry type="string" table="" value="history_last_used" alias="history_last_used" function="UNIX_TIMESTAMP" />
72 </select-data-from-list>
74 And the column list to perform the WHERE statement on.
76 <where-select-from-list>
78 A single entry to perform the WHERE statement on:
79 - table = table name (or alias)
81 - condition = look-up condition
82 - look-for = What to look for
84 <where-select-from-list-entry type="string" table="" value="history_subject" condition="EQUALS" look-for="NICKNAME_CHANGED" />
86 A single entry to perform the AND statement on:
87 - table = table name (or alias)
89 - condition = look-up condition
90 - look-for = What to look for
92 <where-select-from-list-entry type="string" table="" value="history_userid" condition="EQUALS" look-for="$content[userid]" />
93 </where-select-from-list>
95 Columns to perform the ORDER BY statement (GROUP BY is not yet supported)
99 A single entry to perform the ORDER BY statement on, see above WHERE entry for details.
101 <order-by-list-entry type="string" table="" order="history_added" value="DESC" />
105 List all column names from the 'select-data-from-list' node here, but now
106 with call-back informations. The list must only contain those entries where
107 a call-back function shall be called for.
109 <column-callback-list>
111 Another column, now we need a second parameter here because
112 generateDateTime() expects two parameters (first is always the data
115 <column-callback-list-entry>
117 The actual data, again.
119 <column-callback-data type="string" value="history_added" callback="generateDateTime" />
121 More parameters, remember that the first parameter is always given
122 and that it is the data from column.
124 <callback-extra-parameter-list>
126 A single parameter, 'type' can be one of 'float', 'int',
127 'bool', 'string'. 'array' is not yet supported.
129 <callback-extra-parameter-list-entry type="int" column="history_added" value="2" />
130 </callback-extra-parameter-list>
131 </column-callback-list-entry>
133 Another column, now we need a second parameter here because
134 generateDateTime() expects two parameters (first is always the data
137 <column-callback-list-entry>
139 The actual data, again.
141 <column-callback-data type="string" value="history_last_used" callback="generateDateTime" />
143 More parameters, remember that the first parameter is always given
144 and that it is the data from column.
146 <callback-extra-parameter-list>
148 A single parameter, 'type' can be one of 'float', 'int',
149 'bool', 'string'. 'array' is not yet supported.
151 <callback-extra-parameter-list-entry type="int" column="history_last_used" value="2" />
152 </callback-extra-parameter-list>
153 </column-callback-list-entry>
154 </column-callback-list>
156 How the named column shall be logical linked to the above.
158 <where-condition type="string" name="history_userid" condition="AND" />