25.12.2008 - CakePHP 1.2 ist nun stable!

Und ein neuer Cheatsheet samt TextMate Bundle ist auch dabei :)

Fröhliche Weihnachten!

Ankündigung gibt es dort
Download gibt es hier

Ein neues Lieblingsfeature von mir!

Wer schon mal mit der AuthComponent zu tun hatte kennt sicherlich den Begriff „scope“, womit man festlegen kann welche Bedienung ein Benutzer erfüllen muss damit er sich einloggen kann. Für all die die es nicht Wissen, hier eine Kurzfassung in Bezug auf das Thema dieses Beitrags: Ein „Scope“ ist eine definierte Eingrenzung von Daten. „Named“ bedeutet, dass wir dieser Eingrenzung einen Namen geben.

Oft haben Daten diverse Eigenschaften welche die Auswahl erleichtern sollen. Nehmen wir zum Beispiel einen Blog-Eintrag. Dieser kann unsichtbar sein, kann ein Entwurf oder veröffentlicht sein.

All dies gilt bei der Anzeige im Frontend zu berücksichtigen, sowie an allen anderen Stellen innerhalb der Applikation. Je nach Anzahl der Eigenschaften kann das schnell zu Chaos führen. Vor allem, wenn man in einem Team arbeitet und nicht jeder unbedingt weiss was es mit den Eigenschaften auf sich hat.

Genau hier helfen NamedScopes, welche es erlauben diese Eigenschaften zu bündeln und so unter einen Hut zu bringen. Und das nicht etwa innerhalb des Controllers, sondern direkt in dessen Model.

Für unseren Blogeintrag gehen wir mal folgende Konstellationen durch:

Die Eigenschaft is_visible ist quasi unsere Admin-Direktive die es uns erlaubt Beiträge komplett von der Seite zu nehmen, deshalb ist die Eigenschaft in „public“ und „drafts“ auch immer vertreten.

Mit diesem Satz an Scopes können wir nun loslegen unsere find() Operationen zu machen. Hier ein paar Beispiel wie man diese einsetzt:

Wie man im letzten Beispiel sieht nutze ich den Namen des Scopes als Methode. Das macht NamedScopes von alleine und erlaubt uns den Scope so zu verwenden als wäre es die find-Methode selbst. Nur eben unter Berücksichtigung unserer Eigenschaften!

Es gibt also auch nach der Definition der Scopes folgende Methoden im Model:
Model::visible(), Model::public(), Model::drafts()

Ein weiterer Vorteil von NamedScopes ist, wenn eine neue Eigenschaft hinzugefügt werden muss. Normalerweise müsste man durch alle Stellen im Code gehen und überall „is_whatever“ einfügen, aber mit NamedScopes braucht man nur innerhalb der Modeldatei die Definitionen im Array anpassen. Also schneller kann man so was nicht hinbekommen und spart somit einen Haufen Arbeit.

Links zum Thema:
- http://developingwithstyle.com/2008/11/20/namedscope-or-cakephp/
- http://github.com/joelmoss/cakephp-namedscope/

Auto-Korrektur AUS - Danke, apple.

Wenn man das debug_kit Plugin benutzt und dann ThemeView benutzen will gibt es ein kleines Problem: Das debug_kit kommt mit einem eigenem View und überschreibt somit die im AppController definierte Eigenschaft.

Wer also Themes aktivieren will muss sich dem debug_kit entledigen. Hat ein wenig gedauert bis ich den Grund gefunden habe, aber ein wenig manuelles Debugging in "beforeRender" brachte Licht ins Dunkel. Hoffe ich kann mit der Info einigen ein paar Kopfschmerzen ersparen ;-)

----- English -----
If you are using the debug_kit plugin and you want to enable themes in your CakePHP application you will run into a problem. debug_kit comes with a own view and overwrites whatever $view you've setup in your controllers. So if you wonder why ThemeView is not working, just delete the debug_kit and it will work. I haven't looked at the debug_kit code yet, but i guess there is no workaround to this.

Tutorials:
theming-with-cakephp
theming-your-cakephp-apps-v12
Themes Section/cookbook

-----

UPDATE: Ich habe Mark, den Autor des Plugins, darüber informiert und er schrieb mir heute zurück, dass es doch gemeinsam kompatibel sein sollte.

"[...]From the tests I did as long as $view is set in the controller before your action ie. in your beforeFilter() you should be fine.[...]"

Tooltips.. die kleinen Text-Popups die einem helfen sich zu orientieren. Immer wieder gerne gesehen und wurde auch schon zig-mal programmiert.

Ich hab mir schon so einige fertige Scripts angesehen, aber die meisten machen einfach viel zu viel und nutzen teilweise sogar selber Prototype, nur leider nicht effizient genug.

Meistens werden die DIVs beim Aufruf der Seite generiert und irgendwo unterhalb des BODYs "versteckt". Bei sehr vielen Tooltips/Links kann das den Seitenaufbau extrem verlangsamen. Andere wiederum berechnen gott-weiss-was und haben einen mehrseitigen Umfang. Da oft gleich auch eine Klasse geschrieben wird muss man meist eine weitere Scriptdatei laden, was nochmals den Aufbau verzögert.

Ich schreibe daher meine Tooltips immer selber und bin mittlerweile runter auf 10 Zeilen. Könnte sogar in einer passen, aber man will ja nicht den Überblick verlieren.

• Es wird OnMouseOver ein DIV kreiert mit dem Inhalt des TITLE Attributs eines Links. OnMouseOut wird das DIV einfach wieder entfernt.
• Damit das Browser Tooltip nicht zusätzlich angezeitg wird, verschiebe ich bis zum OnMouseOut den Inhalt des TITLE Attributs kurz in ein Fake-Attribut namens _TITLE.
• Der Selector a[title] wählt nur Anker die auch wirklich ein TITLE Attribut haben. Somit brauchen wir auch nicht mehr zu kontrollieren ob eines vorhanden ist.
• Vom Javascript aus wird nur LEFT gesetzt, TOP braucht man nicht zwingend.
• Am Ende von OnMouseOut prüfe ich ob das nächste Element wirklich die tooltip Klasse hat. Das ist nur eine reine Vorsichtsmaßnahme. Wer dennoch Probleme hat könnte etwas radikaler einfach alle DIVs mit dieser Klasse löschen via getElementsByClassName (ist am schnellsten).

Das nachfolgende CSS kümmert sich um den z-Index und den Abstand zum Cursor.

div.tooltip {
    color: #000;
    background-color: #FAFAFA;
    position: absolute;
    z-index: 9999;
    padding: 5px;
    margin: 5px;
    margin-left: 15px; /* Abstand zum Zeiger */
}

So, und das war's. Wenn man nun irgendwo auf der Seite ein <a ... title="mein tooltip"> platziert hat man einen Link mit Tooltip. Zero config, wenn man so will.

Man kann natürlich auch ohne Probleme auf andere Elemente erweitern. Beispiel: $$('a[title], img[title]')...

Falls jemand Verbesserungsvorschläge hat: Immer her damit!
Script wurde in IE, FF und Safari getestet.

]]>