Doku-Hotline

Birgit Grossmann über Texte, Technik und technische Dokumentation

Search und Reset Buttons für exposed filter Views

Montag 8. Februar 2010 von bgrossmann

Bei Views in Drupal gibt es zwei beliebte Fragestellungen, die vom Module selbst nicht gelöst werden:

a) Der Apply-Button sollte besser ein Search-Button sein.

b) Es sollte einen Reset-Button geben, der die Suche zurücksetzt.

Meine ursprüngliche Lösung für den Search-Button war eine Implementation über die template.php.

function theme_preprocess_views_exposed_form(&$vars, $hook) {
// Change the text on the submit button
$vars['form']['submit']['#value'] = t(’Search’);
// Rebuild the rendered version (submit button, rest remains unchanged)
unset($vars['form']['submit']['#printed']);
$vars['button'] = drupal_render($vars['form']['submit']);
}

Die Frage des Reset-Buttons kam später auf, und ich beschloss, lieber ein eigenes Custom-Module dafür zu nutzen.  Dabei war natürlich erstmal nichts sichtbar - logisch, wenn Module und template.php versuchen, das gleiche zu überschreiben. Also löschte ich den Search-Button aus der template.php und implementierte beide Buttons über ein Custom Module views_formalter.

Das folgende wäre der Code, um für alle Views einen Reset-Button zu liefern:

<?php
/**
* Implementation of hook_form_alter().
*/
function views_formalter_form_alter(&$form, $form_state, $form_id) {
if ($form_id == 'views_exposed_form') {
$reset_button_value = t('Reset');
$current_display = $form_state['view']->current_display;
$form['submit']['#value'] = t(’Search’);
$form['reset'] = array(
‘#type’ => ‘markup’,
‘#value’ => ‘<input class=”form-button” type=”reset”
value=”‘. $reset_button_value . ‘ ” onClick=”javascript:window.location=\”.$GLOBALS['base_url'] .’?q=’. $form_state['view']->display[$current_display]->
display_options['path'] .’\';” />’,
);
}
}
?>

Bei onclick wird der Pfad des Views aufgerufen. Sah zunächst prima aus - dann fiel mir auf, dass das Suchfeld in organic groups ebenfalls ein exposed filter view ist, nämlich og_search. Also eine zusätzliche Abfrage eingebaut:

$exposed_views = array('og_search');
if (!in_array($form_state['view']->name, $exposed_views)) {
$reset_button_value = t(’Reset’);

}

Ursprünglich war diese Abfrage so formuliert, dass explizit diejenigen Views angegeben werden mussten, für die ein Reset-Button gezeigt werden sollte. Da in meinem Projekt die meisten Views den Button zeigen sollten, habe ich die Abfrage umgedreht.

Share/Save/Bookmark

Kategorie: Web | Keine Kommentare »

Theming von hidden CCK fields

Sonntag 7. Februar 2010 von bgrossmann

Der Hintergrund der Entwicklung war der Wunsch, Seiten auf “outdated” setzen zu können und auf dieser Basis dann einen Hinweis in der Seitenausgabe zu haben. Das ließ sich als ein CCK-Feld namens “field_outdated” schnell einbauen, doch wie themen? Der Freund des Analysten ist an dieser Stelle ein strategisch in page.tpl.php platziertes:

<?php print_r($GLOBALS); ?>

Damit ist relativ schnell zu sehen, dass field_outdated ein Objekt der Node ist. Die Abfrage läuft dann auf folgendes hinaus:
Wenn outdated gesetzt ist UND die Eigenschaft ‘view’ empty ist (nämlich bei hidden), dann soll die von mir definierte Variable field_outdated_formatted gesetzt werden, und zwar mit HTML meiner Wahl. In diesem Fall möchte ich “Outdated” erscheinen lassen.

Code für die template.php
function THEME_preprocess_page(&$variables) {
if (!empty($variables['node']->field_outdated) && (empty($variables['node']->field_outdated[0]['value']))) {
$variables['field_outdated_formatted'] = ‘<span class=”outdated”>OUTDATED</span>’;
}
}

Code in page.tpl.php, beispielsweise hinter den Node Title einzugeben:
<?php print $field_outdated_formatted; ?>

Es gelten die üblichen Format-Caveats im Blog hier (demnächst ist wirklich ein neues Theme dran.)

Share/Save/Bookmark

Kategorie: Web | Keine Kommentare »

Drupal-Suche - Problem der nicht-indizierten Nodes

Mittwoch 27. Januar 2010 von bgrossmann

Als mir vor einer Weile in meinem Projekt auffiel, dass einige Nodes nicht gefunden wurden, war ich zunächst auf dem Holzweg und dachte, dass es etwas mit den vielen CCK-Feldern dieser Nodes zu tun hätte.

Aber weit gefehlt - es stellte sich nach mühsamer Suche heraus, dass das Problem durch den Import dieser Nodes hervorgerufen wurde. Offensichtlich erkennt Drupal nur dann Nodes als zu indizierend an, wenn “node_save” durchlaufen wird, was bei einem Import mit dem Node Import Module nicht geschieht. (Für lange Winterabende lohnt sich auch die Lektüre von Roberts Artikel Drupal Search: How indexing works.)

Eine Quick-and-Dirty-Lösung dafür ist, die betreffenden Nodes einmal kollektiv z.B. auf “published” zu setzen und dann manuell den Cron-Job für den Suchindex anzustoßen. In meinem Projekt kein Problem, allerdings nicht empfehlenswert, wenn z.B. viele Subscriber bei diesen Nodes mitlesen, da ein “published” zu einer Mailflut führen könnte ;)

Besser wäre es, entweder das Node Import Module umzuschreiben oder das im Hintergrund arbeitende Force Search Index Module (im Netz aufgestöbert) auf D6 umzuschreiben.

P.S. Tolle Sache mit einer Edel-Suche über Tomcat/Solr, aber auch diese setzt immer auf dem Drupal Search Index auf. Wenn also dort Probleme auftreten, hilft das nicht weiter.

Share/Save/Bookmark

Kategorie: Software | Keine Kommentare »

Drupal Action “Set to read”

Dienstag 12. Januar 2010 von bgrossmann

Eine typische Anforderung bei einer Liste von z.B. ungelesenen Artikeln ist die Möglichkeit, diese per Checkbox und Knopfdruck auf gelesen zu setzen.

In Drupal kann für solche Massenaktionen über Views das Views Bulk Operations Module (VBO) genutzt werden. Der Haken hierbei war leider, dass es für “set to read” keine Action gab. Diese musste daher selbst programmiert werden. Das geschah ausgehend vom Node-Module im Core und mit einem Blick auf Advanced Forum, in dem es eine analoge Funktion für ganze Foren gibt.

“Set to read” bedeutet effektiv, dass der Timestamp-Eintrag in der Tabelle “history” für diese nid und uid geändert wird. Dies würde mit einem Replace gehen, aber da beide andere Codestellen mit Delete/Insert arbeiten, habe ich es analog implementiert.

Der gesamte Integrationspfad ins Drupal-Projekt ist:

  1. Ein set-to-read Module anlegen und in der Modules-Liste unter admin/build/modules aktivieren.
  2. Unter admin/settings/actions/manage prüfen, ob das Module aktiv und die Node-Action “Set to read” verfügbar ist.
  3. Ein Seite mit einem “Bulk Operations” View bauen, und als Action “Set to read” auswählen. Bei sofortigem Abarbeiten sieht der User wenig Effekt, bei der Batch API erscheint der blaue Fortschritsbalken (meiner Meinung nach weniger schön). Auf eine Sicherheitsabfrage und eine Rückmeldung habe ich in meinem Projekt verzichtet, da es sich um keinen kritischen Schritt wie z.B. Löschen handelt.
  4. Dann den View speichern und im Projekt prüfen.

Code für set_to_read.module-Datei (Achtung, beim Insert gibt es zwei unschöne Zeilenumbrüche):

<?php
/**
* Implementation of hook_action_info().
*/
function set_to_read_action_info() {
return array('set_to_read_noderead_action' => array(
'description' => t('Set to read'),
'type' => 'node',
'configurable' => FALSE,
'hooks' => array(
'nodeapi' => array('presave'),
'comment' => array('insert', 'update'), )
)
);
}
/**
* Implementation of the actual function set_to_read_noderead_action()
*/
function set_to_read_noderead_action(&$node) {
global $user;
if ($user->uid) {
$sql = 'delete from {history} ' .
"where nid='" . $node->nid . "' ".
"and uid='" . $user->uid . "'";
db_query($sql);
$sql = 'insert into {history} (nid,uid,timestamp) ' .
"values ('" . $node->nid . "', '" . $user->uid . "', unix_timestamp()) ";
db_query($sql);
}
}
?>

Share/Save/Bookmark

Kategorie: Software, Web | Keine Kommentare »

Mehr Drupal

Samstag 9. Januar 2010 von bgrossmann

Da sich inzwischen doch einiges an Know-how und auch ein wenig Code angesammelt hat, wird es hier in Zukunft mehr Drupal-Beiträge geben. Dabei ist mir mal wieder aufgefallen, dass mein Blogdesign extrem untauglich für Code-Publikation ist, da ständig die Zeilen schlecht umgebrochen werden. Da wird wohl in absehbarer Zeit mal ein Redesign fällig.

Drupal ist jedenfalls am Boomen. Nebeneffekt davon ist, dass hier die erste Projektanfrage gelandet ist (von einer Firma in Stuttgart, die wohl immer noch gerne Unterstützung hätte und zumindest gestern noch mit dem Stichwort “Drupal” bei Monster.de auftauchte). Trotz aller Versuche vor und nach Weihnachten konnte ich die “2-3 Tage vor Ort, Templates, Programmierung” nicht an andere Drupalisten weiterreichen, was vermutlich auch an der Mischung lag - die wenigsten fühlen sich in Design und Programmierung zuhause. Wenn die Firma in Hamburg gewesen wäre, wäre ich vielleicht mal einen Tag auf Verdacht vorbeigefahren, aber Stuttgart ist etwas weit für so eine Aktion. Schöne Arbeitswelt, die Arbeit nicht vergeben bekommt :)

Für das Drupalcamp in Essen im Februar bin ich inzwischen auch angemeldet, und freue mich sehr, alte und neue Gesichter zu treffen. Am Freitag abend wird es wohl ein Aufwärmtreffen geben, und bisher plane ich dabeizusein. Vielleicht biete ich auch einen Showcase an… aber das muss ich erst noch absprechen.

Share/Save/Bookmark

Kategorie: Web | Keine Kommentare »

Bericht zum Drupalmediacamp.ch

Montag 11. Mai 2009 von bgrossmann

Am Freitag und Samstag war ich beim Drupalmediacamp in Aarau und muss rückblickend sagen, dass es eine extrem gute Entscheidung war, dorthin zu fahren. Zum einen konnte ich eine Menge Kontakte vom Kölner Drupalcamp vertiefen und zum anderen viele neue Informationen einholen.

Die letzten Monate an Beschäftigung mit VMs, XAMPP, Drupal und der Dokumentation eines C++-basierten SDK haben sich außerdem dahingehend bezahlt gemacht, dass ich jetzt auch recht entwicklungsnahe Sessions nicht nur verstanden habe, sondern auch hoffe, diese für unser Projekt umsetzen zu können.

Die Sessions (die Links führen zu weiteren Infos und ggf. vorhandenen Materialien&Filmen):

Alleine drei meiner Favoriten wurden von Jonathan Minder aka jon gehalten, der sehr techniknah arbeitet und viel Background-Informationen auch zur Frage des Stagings mit svn/Testserver/Lifeserver lieferte. Alle Vorträge sind in seinem Blog zu finden.

Kantonschule Enge: Wie die grösste Kantonschule Zürichs Drupal erfolgreich einsetzt: Hier sprach jon ausführlich über die Vorteile von Drupal vs. Typo3, was mich nochmals in unserer Wahl bestärkt hat. Außerdem wurde dieses Projekt in einem kurzen Zeitrahmen mit recht wenig Programmieraufwand erstellt.

Apache Solr: Hier beschrieb jon die Geschichte, Funktionen und Vorteile von Aache Solr und die Verbindung mit Drupal. Da wir für unser Intranet ja nicht die Acquia-Suche buchen können, ist das lokale Installieren von Solr die richtige Wahl für unsere Suche, und die Facets-Funktion ist spitze!

Workshop: Wie richte ich eine perfekte Drupal - Entwicklungsumgebung mit PHP Debugger ein: Hier stellte jon die Einbindung der freien IDE Aptana mit Drupal vor; ist ggf. für uns aktuell der Overkill, aber es beruhigt zu wissen, wie es gehen würde.

Den ganzen Beitrag lesen »

Share/Save/Bookmark

Kategorie: Software, Web | Keine Kommentare »

Drupal-Patches anwenden

Montag 13. April 2009 von bgrossmann

Bisher habe ich mich in Diskussionen auf drupal.org eher mit Schaudern von den patch files ferngehalten, z.B.

Heute allerdings wollte ich ein Panel-Problem beheben und versuchte mein Glück. Hier der schnellste Weg zum Patch:

  1. Patch bei Drupal herunterladen und in ein temp-Verzeichnis speichern.
  2. Die zu patchende Datei ebenfalls ins temp-Verzeichnis speichern.
  3. Die Anwendung “Patch” für Windows von Sourceforge herunterladen: Patch
  4. Eine Windows-Console aufmachen, in den Pfad von Patch wechseln und das Programm starten:
    patch [original] [patch]
  5. Falls eine Fehlermeldung wie “Assertion failed, hunk, file patch.c, line 343″ kommt, Patch mit binary-Option starten:
    patch --binary [original] [patch]

Hintergrund des Fehlers ist, dass unter Windows die Patch-Datei eine Textdatei sein muss, d.h. CR-LF als Zeilenende. Eine Datei mit LF führt zu failed.

Fertig!

Share/Save/Bookmark

Kategorie: Software | Keine Kommentare »

Drupal-Umzug “quick and dirty”

Samstag 11. April 2009 von bgrossmann

Neben Möglichkeiten wie Datenbank-Export oder dem Nutzen von Modulen wurde mir auch gerade ein Trick verraten, wie man ggf. schneller umziehen kann. Dafür muss als Vorbedingung auf dem Original-Server (Server 1) die MySQL-Datenbank gestoppt werden, damit die Daten konsistent sind.

  1. Auf Server 2 XAMPP installieren und Apache/MySQL starten.
  2. Das Verzeichnis unterhalb von htdocs, z.B. “drupal” von Server 1 ins analoge Verzeichnis auf Server 2 kopieren.
  3. Aus dem Verzeichnis mysql/data/ das Verzeichnis der Datenbank, z.B. “drupaldb”, von Server 1 ins analoge Verzeichnis auf Server 2 kopieren.
  4. Auf Server 2 einen neuen Benutzer anlegen, mit dem Namen & Passwort des DB-Benutzers der drupaldb von Server 1.
  5. Dem Benutzer alle Rechte an der drupaldb zuweisen.
  6. Im Browser localhost/drupal auf Server 2 aufrufen.

An diesem Punkt sollte die Drupal-Startseite erscheinen. Ansonsten nochmals prüfen, ob der db-Benutzer korrekt zugreifen kann.

Share/Save/Bookmark

Kategorie: Web | Keine Kommentare »

Drupal-Intranet, Teil 2

Freitag 10. April 2009 von bgrossmann

Mal wieder eine lange Drupal-Nacht. Neue Erkenntnisse:

Auf admin/build/modules werden Module endabled/disabled. Dabei bleiben die Datenbanktabellen erhalten. Ein Uninstall mit Löschen der Datenbank ist über admin/build/modules/uninstall möglich (hier gibt es ausführliche Infos dazu).

Dann kämpfe ich gerade mit langen Fehlermeldungen, die beim Aufruf von Admin-Menüs auftreten, im Stil von user warning: Duplicate entry 'admin/content/types' for key 1 query: INSERT INTO menu_router... Infos dazu finden sich unter User error: Duplicate entry, allerdings ist die Lösung wohl nicht auf Drupal 6.x übertragbar, da es dort keine sequences-Tabelle mehr gibt.

Etwas undurchschaubar ist für mich aktuell noch der Zusammenhang zwischen Context, Spaces und Groups (das einzige, was ich schon implementiert habe). Dafür gibt es allerdings diverse Artikel (z.T. mit Videos), die ich mir anschauen werde:
Introducing Spaces for Drupal
Building a “Blog Feature” in Drupal with Context and Spaces
Defining Spaces Features in Code in Drupal
Context, Spaces, and Organic Groups
Spaces: A Paradigm for Reusable Drupal Features

Und noch ein Link-Tipp zu Organic Groups: Fine-tune your Drupal CMS with Organic Groups.

Share/Save/Bookmark

Kategorie: Web | Keine Kommentare »

Wieder was gelernt

Sonntag 5. April 2009 von bgrossmann

WSOD = White Screen of Death

Wenn man beim Aufruf einer CMS-Seite gar nichts sieht ;)

Share/Save/Bookmark

Kategorie: Web | Keine Kommentare »