Make your plugin compatible to Admidio 4 [Admidio-Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Make your plugin compatible to Admidio 4 ======

==== New menu calls ====
In Admidio 4 we have changed the way the menu is structured. For this you have to change your plugin if you have worked with $page->getMenu(); before.

Now you don't have to create an instance of the menu to add the single entries there. Also there is now a simple function to add a back button to the page.

So far you had to do the following steps for the back button:
<code php>$page = new HtmlPage('My Headline');
$myMenu = $page->getMenu();
$myMenu->addItem('menu_item_back', $gNavigation->getPreviousUrl(), $gL10n->get('SYS_BACK'), 'fa-arrow-circle-left');</code>
Now it's only necessary to call the following function:
<code php>$page = new HtmlPage('My Headline');
$page->setUrlPreviousPage($gNavigation->getPreviousUrl());</code>
If you want to add a menu entry to the page than just add this code:
<code php>$page->addPageFunctionsMenuItem('menu_item_new', 'Name of Menuentry', ADMIDIO_URL.FOLDER_MODULES.'/groups-roles/groups_roles_new.php', 'fa-plus-circle');</code>

==== Replaced functions ====
''$page->hideThemeHtml();'' is replaced by ''$page->setInlineMode();''

''$page->hideMenu();'' is replaced by ''$page->setInlineMode();''

''safeurl('your-url')'' is replaced by ''SecurityUtils::encodeUrl('your-url')''

==== Changed methods ====
The HtmlPage constructor has become a new necessary parameter:
<code php>$page = new HtmlPage('My Headline');
// must now be
$page = new HtmlPage('admidio-page-id', 'My Headline');</code>

New method to open the modal window. Just add a class and a data-href:
<code html><a class="openPopup" href="javascript:void(0);" data-href="http://www.example.com">My Link to a modal window</a></code>

==== Changed constants ====
''FIELD_DEFAULT'' is replaced by ''HtmlForm::FIELD_DEFAULT''

''FIELD_REQUIRED'' is replaced by ''HtmlForm::FIELD_REQUIRED''

''FIELD_DISABLED'' is replaced by ''HtmlForm::FIELD_DISABLED''

''FIELD_READONLY'' is replaced by ''HtmlForm::FIELD_READONLY''

''FIELD_HIDDEN'' is replaced by ''HtmlForm::FIELD_HIDDEN''