Veraltet:Neues Admin-Tool: Frontendfilter

thorn

Offline

Posts: 980

Veraltet:Neues Admin-Tool: Frontendfilter

« on: December 26, 2008, 08:43:57 PM »

Dieses Modul wurde ersetzt durch das Modul Outputfilter-Dashboard.

Hallo

anbei ein neues Admin-Tool für WebsiteBaker 2.7 (mit core-replacement), dessen Aufgabe es sein soll eine "Schnittstelle" zwischen WB und Frontend / Output-Filtern zu bilden.

Voraussetzungen:
WB 2.7 (original ~~oder letzte SVN-Version~~),
PHP 4.1

Zur Zeit ist es ja so, das man jeweils das Template ändern muss um solche Filter einzubinden. Durch dieses Admin-Tool können die Filter dagegen als Modul installiert werden - oder als sog. "Inline-Filter" direkt über ein Textfeld eingegeben werden (als PHP-Code).
Javascript und CSS kann, wenn vom Filter benötigt, ebenfalls automatisch in den <head>-Bereich geladen werden.
Zur Erleichterung der Filter-Programmierung gibt es ein paar Hilfsfunktionen (find_class, add_class, register_frontend_f iles, register_onload_eve nt, und was man halt so braucht).

Ein ganz einfacher "Inline-Filter" könnte z.B. so aussehen:

Code: (einfacher Filter)

<?php
// simple filter which will convert all U to X in $content
function opff_x_as_u(&$content, $page_id, $section_id, $module, $wb) {
$content = str_replace('U', 'X', $content);
return(TRUE);
}
?>

Ein anderes Beispiel: Um einen Umbruch im Menu zu erzwingen, kann man diesen "Inline-Filter" benutzen.
Er wandelt ein '#' im Menu-Title in ein <br /> um (das Theme war vor kurzem mal irgendwo im Forum).

Code: (Linebreak in Menu)

<?php
// PAGE_LAST-Filter: all '#' in menu-title will be converted to '<br />',
// to achieve an explicitly line-break in menu:
// use menu-title e.g.: "entry# with linebreak", which will be converted to entry<br /> with linebreak
// This example assumes that all menu-links will have a class="menu..." set.
function opff_menu_linebreak(&$content, $page_id, $section_id, $module) {
  // cut pieces out of $content
  $extracts = opf_cut_extract($content, '<a href=[^>]*class="menu[^>]*>(.*)</a>', 1, 'iUs');
  // check if opf_cut_extract() returned without error
  if($extracts) {
    foreach($extracts as $key => $str) {
      // modify
      $extracts[$key] = str_replace('#','<br />', $str);
    }
    // write $extracts back to $content
    opf_glue_extract($content, $extracts);
    return(TRUE);
  } else {  // opf_cut_extract() failed. $content may be damaged, so return FALSE
    return(FALSE);
  }
}
?>

Ein paar "richtige" Filter folgen noch in den nächsten Tagen.

Installation:

frontendfilter1.1.0 .zip wie ein ganz normales Modul in WebsiteBaker installieren.
frontendfilter_core .zip von Hand entpacken.(Dies muss nur beim ersten installieren durchgeführt werden.) Darin befinden sich zwei Dateien, die auf dem Server ausgetauscht werden müssen (wb/index.php und wb/framework/frontend.functions.php).
~~Alternativ sind diese beiden Dateien auch in der aktuellen Version (rev886) aus dem SVN-Repository beigelegt (wb/index_rev886.php und wb/framework/frontend.functions_rev886.php).~~

Edit:
Die Modul/Seiten-Auswahl mit den drei Bäumen ist irgendwie noch etwas unausgegoren -- da ist mir aber noch nichts besseres eingefallen. - Wer Vorschläge hat, bitte her damit.
Zur Zeit ist es so, dass ein Filter (Typ SECTION) nur dann angewendet wird, wenn das passende Modul, UND in mindestens einem der beiden Seitenbäume, die passende Seite markiert ist.

thorn.

Update: frontendfilter 1.0.6: Fixed some issue with allowedit and EditArea.
Update: frontendfilter 1.0.7: Upated opf_register_fronte nd_files() to allow IE-conditional script ()
Update: frontendfilter 1.1.0: opf_register_filter(): added 'additional_fields' and 'additional_fields_l anguages', to add additional config fields.

PS: Ich suche Freiwillige für die notwendigen Übersetzungen - vor allem (aber nicht ausschließlich) ins englische embarassed

Wenn sich da jemand erbarmen könnte -- wäre echt nett.
Es geht zum einen um die Sprachdatei unter /languages, aber dann auch um die Hilfe unter /help.
Bei der Hilfe einfach den Inhalt aus help/DE/* nach z.B. help/EN/ kopieren, und die einzelnen Dateien übersetzen...


« Last Edit: July 22, 2010, 08:57:53 PM by thorn »	Logged

Projekte

Ralf (Berlin)

Offline

Posts: 1314