Plugins¶

Creating a Plugin¶

Als funktionierendes Beispiel, erstellen wir ein Plugin welches für Dich Pizza bestellt. Zum starten, benötigen wir einen Platz für unsere Plugin-Dateien innerhalb des /app/plugins Ordners. Der Name des Elternordners für alle Dateien des Plugins, ist sehr wichtig und wird in vielen Bereichen genutzt. Wähle also eine sinnvolle Bezeichnung. Für unser Plugin nutzen wir den Namen „Pizza“.

/app
    /plugins
        /pizza
            /controllers                <- Plugin  Controllers
            /models                     <- Plugin  Models
            /views                      <- Plugin  Views
            /pizza_app_controller.php   <- Plugins AppController
            /pizza_app_model.php        <- Plugins AppModel

// /app/plugins/pizza/pizza_app_controller.php:
<?php
class PizzaAppController extends AppController {
     //...
}
?>

// /app/plugins/pizza/pizza_app_model.php:
<?php
class PizzaAppModel extends AppModel {
       //...
}
?>

Plugin Controllers¶

Wie Du nun wissen solltest, werden Controller für unser Pizza Plugin unter /app/plugins/pizza/controllers/ abgespeichert.

Nachdem die Hauptaufgabe des Plugins darin besteht, Pizza Bestellungen entgegen zu nehmen, benötigen wir einen OrdersController.

Um Namenskonflikte mit bereits vorhandenen Controllern der Eltern-Anwendung zu vermeiden, wird empfohlen einen verhältnismäßig einzigartigen Namen zu verwenden. Es ist gut möglich das die Eltern-Anwendung, vielleicht bereits einen UsersController, OrdersController, oder ProductsController enthält. Also sollten wir bei der Namensfindung ein bisschen kreativ sein oder wir setzen einfach den Plugin-Namen als Präfix vor den eigentlichen Controller-Namen. In unserem Fall wäre das PizzaOrdersController.

Also speichern wir unseren neuen PizzaOrdersController im Ordner /app/plugins/pizza/controllers/ ab und das ganze sieht dann so aus:

// /app/plugins/pizza/controllers/pizza_orders_controller.php
class PizzaOrdersController extends PizzaAppController {
    var $name = 'PizzaOrders';
    var $uses = array('Pizza.PizzaOrder');
    function index() {
        //...
    }
}

Achte dararuf wie der PizzaOrdersController den AppController des Plugins (PizzaAppController) erweitert. Wir erweitern also nicht direkt den AppController von CakePHP sondern gehen den Weg, über den von uns erstellten PizzaAppController.

Achte auch dararuf wie der Name des Models mit einem Präfix, nämlich mit dem Namen des Plugins, versehen wird. Diese Linie mit Code wurde nur aus Klarheitsgründen aufgezeigt und ist für unser Beispiel nicht notwendig.

Wenn Du auf das, was wir bisher umgestezt haben, zugreifen möchtest, besuche /pizza/pizzaOrders und Du solltest eine “Missing Model” Fehlermeldung erhalten, da wir noch kein PizzaOrder Model definiert haben.

Plugin Models¶

Models für das Plugin werden unter /app/plugins/pizza/models abgelegt. Wir haben bereits einen PizzaOrdersController für das Plugin definiert, also wollen wir nun das Model für diesen Controller erstellen. Der Name des Models lautet PizzaOrder und erweitert unser PizzaAppModel. (Der Klassen-Name PizzaOrder ist konsistent mit der Namensgebung und einzigartig genug, so dass wir den Namen so belassen können).

// /app/plugins/pizza/models/pizza_order.php:
<?php
class PizzaOrder extends PizzaAppModel {
    var $name = 'PizzaOrder';
}
?>

Nachdem Du eine Tabelle ‘pizza_orders’ in Deiner Datenbank erstellt hast, kannst Du /pizza/pizzaOrders im Browser aufrufen und Du solltest eine Fehlermeldung „Missing View“ erhalten. Also lass uns im nächsten Schritt einen View erstellen.

Falls Du eine Referenz zu einem Model innerhalb Deines Plugins benötigst, musst Du den Namen des Plugins mit dem Namen des Models, getrennt durch einen Punkt, einbinden.

Beispiel einer Referenz:

// /app/plugins/pizza/models/pizza_order.php:
<?php
class ExampleModel extends PizzaAppModel {
    var $name = 'ExampleModel';
        var $hasMany = array('Pizza.PizzaOrder');
}
?>

Plugin Views¶

Views benehmen sich exakt genau so, wie sie es auch in einer normalen Anwendung machen. Du musst Sie nur in dem richtigen Ordner ablegen: Und zwar innerhalb des /app/plugins/pizza/views/ Ordners.

Bei unserem Pizza Plugin, brauchen wir einen View für unsere PizzaOrdersController::index() Action. Lass uns diese ebenfalls erstellen:

// /app/plugins/pizza/views/pizza_orders/index.ctp:
<h1>Order A Pizza</h1>
<p>Nothing goes better with Cake than a good pizza!</p>
<!-- An order form of some sort might go here....-->

/app/views/plugins/pizza/pizza_orders/index.ctp

Components, Helpers and Behaviors¶

Ein Plugin kann, genau wie auch eine reguläre CakePHP Anwendung, Components, Helpers und Behaviors beinhalten.

Du kannst ebenso ein Plugin entwickeln welches ausschließlich aus Components, Helpers und Behaviors besteht. Dies ist sehr praktisch, falls man mehrfach verwendbare Bestandteile, in verschiedenen Projekten einsetzen möchte.

Diese Komponenten zu erstellen, ist nichts anderes als das entwickeln einer regulären CakePHP Anwendung, ohne spezielle Namenskonventionen.

Referring to your components from within the plugin also does not require any special reference.

// Component
class ExampleComponent extends Object {

}

// within your Plugin controllers:
var $components = array('Example');

To reference the Component from outside the plugin requires the plugin name to be referenced.

var $components = array('PluginName.Example');
var $components = array('Pizza.Example'); // references ExampleComponent in Pizza plugin.

Die selbe Technik wird auch für Helpers und Behviors angewendet.

Plugin assets¶

New for 1.3 is an improved and simplified plugin webroot directory. In the past plugins could have a vendors directory containing img, js, and css. Each of these directories could only contain the type of file they shared a name with. In 1.3 both plugins and themes can have a webroot directory. This directory should contain any and all public accessible files for your plugin

app/plugins/debug_kit/webroot/
                                css/
                                js/
                                img/
                                flash/
                                pdf/

And so on. You are no longer restricted to the three directories in the past, and you may put any type of file in any directory, just like a regular webroot. The only restriction is that MediaView needs to know the mime-type of that asset.

Linking to assets in plugins

The urls to plugin assets remains the same. In the past you used /debug_kit/js/my_file.js to link to app/plugins/debug_kit/vendors/js/my_file.js. It now links to app/plugins/debug_kit/webroot/js/my_file.js

It is important to note the /your_plugin/ prefix before the img, js or css path. That makes the magic happen!

Plugin Tipps¶

So, nun haben wir alles fertiggestellt. Das Plugin ist bereit zur Veröffentlichung.

Wir empfehlen Dir, ein paar Extras, wie z.B. eine README Datei für eventuelle Installationshinweise oder Anmerkungen zur Funktionsweise und eine SQL Datei für den Datenbank-Import zur Verfügung zu stellen.

Wenn Du das Plugin unter /app/plugins installiert hast, kannst Du es über folgende URL aufrufen: /[pluginname]/[controller]/[action]. In unserem Pizza Plugin Beispiel, wäre das für unseren PizzaOrdersController also /pizza/pizzaOrders.