Adminer in YForm verlinken
Es könnte ja sein, dass man als Entwickler bzw. Admin mal eben in der Datenbank selbst nach dem Rechten sehen, Ergebnisse kontrollieren oder sonstwie eingreifen möchte oder muss. Das empfehlenswerte Addon "Adminer" bietet hierfür zahlreiche Möglichkeiten.
In diesem Trick wird beschrieben, wie der Adminer direkt aus einer YForm-Tabelle heraus aufgerufen werden kann. Dazu werden Buttons an den passenden Stellen im Table-Manager und der Datentabelle eingebaut.
- Aus der Tabellenübersicht des YForm-Table-Manager direkt in den Adminer springen (analog zum Adminer-Button im Hauptmenü). Beispiel
- Aus der Tabellenübersicht des YForm-Table-Manager im Adminer die Tabelle
rex_yform_fieldanzeigen. Beispiel - Aus der Tabellenübersicht des YForm-Table-Manager im Adminer die jeweilige Tabelle anzeigen. Beispiel
- Aus der Tabellenübersicht des YForm-Table-Manager im Adminer die Tabelle
rex_yform_fieldanzeigen, jedoch auf die Felder der jeweiligen Tabelle gefiltert. Beispiel
- Aus der Datensatz-Ansicht der Tabelle im Adminer die jeweilige Tabelle anzeigen (analog zu 3.). Beispiel
- Aus der Datensatz-Ansicht der Tabelle im Adminer in den Datensatz springen (Edit). Beispiel
Das Verfahren ist kompatibel zum Trick YForm-Tabellen und Formulare im eigenen Addon einbinden
Einschränkungen
Der Adminer ist ein reines Admin-Tool, wie der Name schon nahelegt. Im Beispielcode werden die Button nur eingebaut, wenn der eingeloggte Beutzer Admin-Rechte hat und der Adminer verfügbar ist.
Andockpunkte
Die Button werden über Extension-Points eingehängt. Die Buttons rufen letztlich nur eine URL in einem neuen Fenster auf, wie sie der Adminer intern benutzt.
page=yform/manager/table_edit und EP REX_LIST_GET
Die Liste der YForm-Tabellen wird per rex_list aufgebaut. Über den EP REX_LIST_GET erhält die Liste
eine zusätzliche Spalte mit zwei Button. Im Spaltentitel werden der Adminer allgemein (1.) und die
Tabelle rex_form_field im Adminer (2.) aufgerufen In den Zeilen wird der Adminer für die jeweilige
Tabelle (3.) bzw. rex_form_field gefiltert auf die Tabelle (4.) aufgerufen.
EP YFORM_DATA_LIST_LINKS
Der EP ermöglicht, die Buttons in der Tabellen-Kopfzeile zu beeinflussen. Für den Adminer wird ein zusätzlicher Button am Anfang der Liste eingefügt, der die angezeigte Tabelle im Adminer öffnet (5.).
EP YFORM_DATA_LIST_ACTION_BUTTONS
Der EP ergänzt das Submenü mit Datensatz-Aktionen um eine weiteren Button, der genau diesen Datensatz im Adminer zum Editieren öffnet (6.).
PHP-Code
Der Code kann z.B. via boot.php der Projekt-Addons für das Backend ausgeführt werden.
/**
* Adminer-Buttons in YForm-Tabellen einbauen
*/
if( ($user = \rex::getUser()) && $user->isAdmin() && \rex_addon::get('adminer')->isAvailable() ) {
\rex_extension::register('YFORM_DATA_LIST_LINKS', function( \rex_extension_point $ep){
if( !$ep->getParam('popup') ) {
$item = [
'label' => '<i class="rex-icon rex-icon-database" title="Adminer"></i>',
'url' => \rex_url::backendPage('adminer',['select'=>$ep->getParams()['table']->getTableName()]),
'attributes' => [
'class' => ['btn-default'],
'target' => ['_blank']
]
];
$links = $ep->getSubject();
array_unshift( $links['table_links'], $item );
$ep->setSubject($links);
}
});
\rex_extension::register('YFORM_DATA_LIST_ACTION_BUTTONS',function( \rex_extension_point $ep){
$url = \rex_url::backendPage(
'adminer',
[
'edit'=>$ep->getParam('table')->getTableName(),
'where[id]'=>'___id___',
'username' => ''
]);
$buttons = $ep->getSubject();
$buttons['adminer'] = '<a href="'.$url.'" target="_blank"><i class="rex-icon rex-icon-database"></i> Adminer</a>';
return $buttons;
});
if( 'yform/manager/table_edit' === \rex_be_controller::getCurrentPage() ) {
\rex_extension::register('REX_LIST_GET', function( \rex_extension_point $ep){
$list = $ep->getSubject();
$page = $list->getParams()['page'] ?: '';
if( 'yform/manager/table_edit' === $page ){ # sicher ist sicher
// Namen, Urls und Icons vorab festlegen
$columnName = md5('Adminer');
$tableIcon = '<i class="rex-icon rex-icon-database"></i>';
$fieldIcon = '<i class="rex-icon rex-icon-template"></i>';
$tableUrl = \rex_url::backendPage(
'adminer',
[
'username' => '',
'db' => \rex::getDbConfig(1)->name,
]);
$fieldUrl = \rex_url::backendPage(
'adminer',
[
'username' => '',
'db' => \rex::getDbConfig(1)->name,
'select'=>'rex_yform_field',
'where[0][col]'=>'table_name',
'where[0][op]'=>'=',
]);
// Spalte in die Liste einbauen
$list->addColumn( md5('Adminer'),'',-1, [
'<th class="rex-table-icon">'.
'<a href="'.$tableUrl.'" target="_blank" title="Adminer">'.$tableIcon.'</a>'.
'<a href="'.$tableUrl.'&select=rex_yform_field" target="_blank" title="Adminer: YForm-Felder">'.$fieldIcon.'</a>'.
'</th>',
'<td class="rex-table-icon">'.
'<a href="'.$tableUrl.'&select=###table_name###" target="_blank" title="Adminer: Tabelle ###table_name###">'.$tableIcon.'</a>'.
'<a href="'.$fieldUrl.'&where[0][val]=###table_name###" target="_blank" title="Adminer: YForm-Felder der Tabelle ###table_name###">'.$fieldIcon.'</a>'.
'</td>'
]);
}
});
}
}
Beispiele
Passend zu den obigen Nummern hier die Ergebnisse
1 Adminer allgemein
2 Tabelle rex_yform_field
3 Die ausgewählte Tabelle
4 Tabelle rex_yform_field für die ausgewählte Tabelle
6 Den aktuellen Datensatz der ausgewählten Tabelle
