2007-11-10 15:40:24 +00:00
|
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
2009-11-26 13:35:23 +00:00
|
|
|
<html><head>
|
2010-01-25 16:38:36 +00:00
|
|
|
|
2010-02-27 19:14:15 +00:00
|
|
|
|
2010-04-05 10:13:37 +00:00
|
|
|
|
2010-06-06 18:14:24 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2010-01-25 16:38:36 +00:00
|
|
|
|
|
|
|
|
<meta http-equiv="content-type" content="text/html; charset=ISO-8859-15"><title>Upgrade notes</title>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2007-11-19 19:16:08 +00:00
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
<link rel="stylesheet" type="text/css" href="style/layout.css">
|
2007-12-09 10:48:44 +00:00
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2010-01-25 16:38:36 +00:00
|
|
|
<link rel="shortcut icon" type="image/x-icon" href="images/favicon.ico"></head><body>
|
2010-01-01 23:18:44 +00:00
|
|
|
<h1>Upgrade notes</h1>
|
2007-12-30 12:32:48 +00:00
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
This is a list of API changes for all LAM releases.
|
|
|
|
|
<br>
|
2008-03-23 14:33:15 +00:00
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
<br>
|
2008-12-09 18:29:58 +00:00
|
|
|
|
2010-06-06 18:14:24 +00:00
|
|
|
<h2>3.0.0 -> 3.1.0</h2>There is a new object-oriented library to
|
|
|
|
|
generate HTML for the account modules (e.g. used for
|
|
|
|
|
display_html_attributes()). This will allow additional functionality
|
|
|
|
|
like client side validation. Please see lib/html.inc or package
|
|
|
|
|
metaHTML in the phpdoc documentation.<br>
|
|
|
|
|
<span style="color: red; font-weight: bold;">Attention: The old array-based meta HTML elements will only be supported until Q2/2011!</span><br>
|
|
|
|
|
<br>
|
|
|
|
|
The PDF editor now supports descriptive PDF
|
2010-04-05 10:13:37 +00:00
|
|
|
fields. You can use this by returning an associative array for the PDF
|
|
|
|
|
fields (e.g. array('macAddress' => _('MAC address'))) in <span style="font-weight: bold;">get_pdfFields()</span> or the meta data.<br>
|
|
|
|
|
The old format is still supported. LAM will continue to show the field name as label in this case.<br>
|
|
|
|
|
<br>
|
|
|
|
|
<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
<h2>2.9.0 -> 3.0.0</h2>
|
2009-03-03 18:36:24 +00:00
|
|
|
|
2010-04-05 10:13:37 +00:00
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
You can now integrate JavaScript libraries by simply putting the files
|
|
|
|
|
into templates/lib. All files with the name *.js are automatically
|
|
|
|
|
included on all pages.<br>
|
2010-02-15 20:21:44 +00:00
|
|
|
There is a new log level LOG_DEBUG available for logNewMessage().
|
|
|
|
|
<br>
|
|
|
|
|
<h3>Module interface:</h3>
|
|
|
|
|
The function
|
|
|
|
|
<span style="font-weight: bold;">build_uploadAccounts()</span>
|
|
|
|
|
has a new parameter
|
2010-02-27 19:14:15 +00:00
|
|
|
<span style="font-weight: bold;">$selectedModules</span>.<br>
|
|
|
|
|
<h3>Type interface:</h3>
|
|
|
|
|
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2010-02-27 19:14:15 +00:00
|
|
|
The new function <span style="font-weight: bold;">supportsFileUpload()</span> specifies if file uploads are supported (default true).<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
<br>
|
|
|
|
|
<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2009-11-26 13:35:23 +00:00
|
|
|
<h2>2.8.0 -> 2.9.0</h2>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
|
|
|
|
Several functions of the <span style="font-weight: bold;">cache</span>
|
|
|
|
|
class were removed.<br>
|
|
|
|
|
|
2009-11-26 13:35:23 +00:00
|
|
|
<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
<br>
|
|
|
|
|
|
2009-03-03 18:36:24 +00:00
|
|
|
<h2>2.5.0 -> 2.6.0</h2>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
|
|
|
|
The class <span style="font-weight: bold; font-style: italic;">baseType</span>
|
|
|
|
|
has two new member variables:<br>
|
|
|
|
|
|
2009-03-03 18:36:24 +00:00
|
|
|
<ul>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2009-03-03 18:36:24 +00:00
|
|
|
<li>$LABEL_CREATE_ANOTHER_ACCOUNT</li>
|
|
|
|
|
<li>$LABEL_BACK_TO_ACCOUNT_LIST</li>
|
|
|
|
|
</ul>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2009-03-03 18:36:24 +00:00
|
|
|
They can be used to show a more specific text when the user is asked to
|
|
|
|
|
create another account or return back to the account list.<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2009-03-03 18:36:24 +00:00
|
|
|
<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2009-03-03 18:36:24 +00:00
|
|
|
The meta HTML code now supports image buttons.<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2009-03-03 18:36:24 +00:00
|
|
|
<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2009-03-03 18:36:24 +00:00
|
|
|
<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2008-12-09 18:29:58 +00:00
|
|
|
<h2>2.4.0 -> 2.5.0</h2>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2008-12-09 18:29:58 +00:00
|
|
|
<h3>Self service</h3>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
|
|
|
|
<span style="font-weight: bold;">$selfServiceSettings</span> in class <span style="font-style: italic;">baseModule</span> is now an object of the
|
|
|
|
|
class <span style="font-style: italic;">selfServiceProfile.</span>
|
|
|
|
|
This way all profile settings can be read. To access the module
|
|
|
|
|
settings use <span style="font-weight: bold;">$this->selfServiceSettings->moduleSettings</span>.<br>
|
|
|
|
|
|
2008-12-09 18:29:58 +00:00
|
|
|
<br>
|
2007-11-10 15:40:24 +00:00
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2008-03-23 14:33:15 +00:00
|
|
|
<h2>2.2.0 -> 2.3.0</h2>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2008-03-23 14:33:15 +00:00
|
|
|
<h3>Style changes</h3>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
|
|
|
|
If you have defined your own account types then you need to update your
|
|
|
|
|
CSS files (style/type_<type>.css).<br>
|
|
|
|
|
|
2008-03-23 14:33:15 +00:00
|
|
|
Please change "table.<type>list input,select" to
|
|
|
|
|
"table.<type>list input,select,button" and
|
|
|
|
|
"fieldset.<type>edit input" to "fieldset.<type>edit
|
|
|
|
|
input,select,button". "fieldset.<type>edit select" may be deleted
|
|
|
|
|
afterwards.<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2008-03-23 14:33:15 +00:00
|
|
|
<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2008-03-23 14:33:15 +00:00
|
|
|
<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<h2>2.1.0 -> 2.2.0</h2>
|
2008-03-23 14:33:15 +00:00
|
|
|
|
2007-12-09 10:48:44 +00:00
|
|
|
<h3>Account lists</h3>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
Account lists now support to define tools. These are displayed as
|
|
|
|
|
linked images like the edit and delete links in the list.<br>
|
|
|
|
|
|
|
|
|
|
Overwrite <span style="font-weight: bold;">lamList::getAdditionalTools()</span>
|
|
|
|
|
to use this feature.<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
The definition of account list options changed. The function <span style="font-weight: bold;">lamList::getAdditionalTools()</span> is no
|
|
|
|
|
longer available. Use these functions instead: <span style="font-weight: bold;">lamList::listGetAllConfigOptions()</span>
|
|
|
|
|
and <span style="font-weight: bold;">lamList::listConfigurationChanged()</span>.<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-11 14:01:16 +00:00
|
|
|
All options are now saved in cookies for one year.<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<br>
|
2007-12-09 10:48:44 +00:00
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
<h3>Base module</h3>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
The <span style="font-weight: bold;">baseModule</span> class has a new
|
|
|
|
|
protected option: <span style="font-weight: bold;">$autoAddObjectClasses
|
|
|
|
|
</span>You can set it to false if you do not want that your module's
|
|
|
|
|
object classes are added when creating or loading an account.<br>
|
2007-12-09 10:48:44 +00:00
|
|
|
|
2007-11-19 19:16:08 +00:00
|
|
|
<br>
|
2007-12-09 10:48:44 +00:00
|
|
|
|
2007-11-19 19:16:08 +00:00
|
|
|
Account modules can now have icons. See <span style="font-weight: bold;">baseModule->getIcon()</span>.<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
|
|
|
|
<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2007-12-28 16:16:03 +00:00
|
|
|
<h3>Constructors</h3>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2007-12-30 12:32:48 +00:00
|
|
|
LAM now uses the PHP5 syntax for constructors: <span style="font-weight: bold;">__construct()<br>
|
|
|
|
|
<br>
|
|
|
|
|
</span>
|
|
|
|
|
<h3>Extended security model</h3>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2007-12-30 12:32:48 +00:00
|
|
|
Each server profile now defines an access level.<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2007-12-30 12:32:48 +00:00
|
|
|
<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2007-12-30 12:32:48 +00:00
|
|
|
Currently these are:<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2007-12-30 12:32:48 +00:00
|
|
|
<ul>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2007-12-30 12:32:48 +00:00
|
|
|
<li>write access</li>
|
|
|
|
|
<li>password changes</li>
|
|
|
|
|
<li>read access<br>
|
|
|
|
|
</li>
|
|
|
|
|
</ul>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
|
|
|
|
<span style="font-weight: bold;"></span> Please check your code and
|
|
|
|
|
prohibit any actions which do not fit the current access level.<br>
|
|
|
|
|
|
|
|
|
|
There are two new functions in <span style="font-style: italic;">security.inc</span>:
|
|
|
|
|
<span style="font-weight: bold;">checkIfWriteAccessIsAllowed()</span>
|
|
|
|
|
and <span style="font-weight: bold;">checkIfPasswordChangeIsAllowed()</span><br>
|
|
|
|
|
|
2007-12-30 12:32:48 +00:00
|
|
|
Only LAM Pro allows to change the access level from <span style="font-style: italic;">write access</span> to a smaller level.<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2007-12-28 16:16:03 +00:00
|
|
|
<br>
|
|
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<h2>2.0.0 -> 2.1.0</h2>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2008-03-23 14:33:15 +00:00
|
|
|
<h3><span style="font-weight: bold;">Style changes</span></h3>
|
|
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<ul>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
<li>"fieldset.<type>edit fieldset" and
|
|
|
|
|
"fieldset.<type>edit fieldset fieldset" were removed.</li>
|
|
|
|
|
<li>"table.<type>list input" changed to "table.<type>list
|
|
|
|
|
input,select"</li>
|
2007-11-10 15:40:24 +00:00
|
|
|
</ul>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2008-03-23 14:33:15 +00:00
|
|
|
<h3><span style="font-weight: bold;">baseModule</span></h3>
|
|
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
The class variable<span style="font-style: italic;"> $base</span>
|
|
|
|
|
is no longer visible in child classes. Please use <span style="font-style: italic;">$this->getAccountContainer()</span> to
|
|
|
|
|
access the accountContainer object.<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
Several other class variables in accountContainer etc. are now private.
|
|
|
|
|
Use the new access methods.<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<h2>1.3.0 -> 2.0.0</h2>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
LAM is now PHP5 only. Several variables are now private and need to be
|
|
|
|
|
accessed via functions.<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<h2>1.2.0 -> 1.3.0</h2>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2008-03-23 14:33:15 +00:00
|
|
|
<h3><span style="font-weight: bold;">New lamList functions</span></h3>
|
|
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<ul>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-11 14:01:16 +00:00
|
|
|
<li><span style="font-weight: bold;">listPrintTableCellContent():</span>
|
|
|
|
|
This function allows you to control how the LDAP attributes are
|
|
|
|
|
displayed in the table. This can be used to display links or binary
|
|
|
|
|
data.</li>
|
|
|
|
|
<li><span style="font-weight: bold;">listPrintAdditionalOptions():</span>
|
|
|
|
|
If you want to display additional conrols for a list please use this
|
|
|
|
|
function. The controls will be placed under the account table.<br>
|
2007-11-10 15:40:24 +00:00
|
|
|
</li>
|
|
|
|
|
</ul>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
No more lamdaemon commands via delete_attributes() and
|
|
|
|
|
save_attributes() in account modules.<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
Please use these new functions to call lamdaemon directly:<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<ul>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<li>preModifyActions()</li>
|
|
|
|
|
<li>postModifyActions()</li>
|
|
|
|
|
<li>preDeleteActions()</li>
|
|
|
|
|
<li>postDeleteActions()</li>
|
|
|
|
|
</ul>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<h2>1.1.x -> 1.2.0</h2>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2008-03-23 14:33:15 +00:00
|
|
|
<h3><span style="font-weight: bold;">API changes</span></h3>
|
|
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<ul>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<li>removed get_configDescription() from module interface</li>
|
|
|
|
|
</ul>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<h2>1.0.4 -> 1.1.0</h2>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2008-03-23 14:33:15 +00:00
|
|
|
<h3><span style="font-weight: bold;">API changes</span></h3>
|
|
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<ul>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2010-01-01 23:18:44 +00:00
|
|
|
<li>removed $post parameters from module functions
|
|
|
|
|
(delete_attributes(), process_...(), display_html_...()). Use $_POST
|
|
|
|
|
instead.</li>
|
2007-11-11 14:01:16 +00:00
|
|
|
<li>process_...()
|
|
|
|
|
functions: returned messages are no longer grouped (e.g. return:
|
|
|
|
|
array(array('INFO', 'headline', 'text'), array('INFO', 'headline2',
|
|
|
|
|
'text2')))</li>
|
2007-11-10 15:40:24 +00:00
|
|
|
</ul>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<h2>1.0.0 -> 1.0.2</h2>
|
|
|
|
|
|
2008-03-23 14:33:15 +00:00
|
|
|
<h3><span style="font-weight: bold;">New module functions</span></h3>
|
|
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<ul>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<li>getRequiredExtensions: Allows to define required PHP extensions</li>
|
2010-01-01 23:18:44 +00:00
|
|
|
<li>getManagedObjectClasses: Definition of managed object classes for
|
|
|
|
|
this module</li>
|
2007-11-10 15:40:24 +00:00
|
|
|
<li>getLDAPAliases: list of LDAP alias names which are replaced by LAM</li>
|
2010-01-01 23:18:44 +00:00
|
|
|
<li>getManagedAttributes: list of LDAP attributes which are managed
|
|
|
|
|
by this module</li>
|
2007-11-10 15:40:24 +00:00
|
|
|
</ul>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
The LDAP attributes are no longer loaded by reading the LDAP schema. If
|
|
|
|
|
your module does not implement the load_attributes() function then you
|
|
|
|
|
have to use getManagedAttributes() or the meta data to specify them.<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
<br>
|
2007-11-18 10:35:56 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
The class variable "triggered_messages" in baseModule was removed.<br>
|
|
|
|
|
|
2007-11-18 10:35:56 +00:00
|
|
|
<br>
|
2010-01-01 23:18:44 +00:00
|
|
|
|
2007-11-10 15:40:24 +00:00
|
|
|
</body></html>
|
