Jumi 2,1 Guide

Wir stellen Jumi 2.1 Beta für Joomla! 1,5 hier. Es gibt so viele Veränderungen in dieser Version!

Wenn 2.1 beta Änderungen in der endgültigen Version und 2.0, werden markiert als abgeschrieben werden wir dieses Dokuments in den Standard Jumi Unterlagen aufgenommen.

Intro

Jumi PLUGIN geändert hat (nach drei Jahren) zu einer anderen. Es gibt keine Abwärtskompatibilität in dieser Syntax, aber Sie können alle früheren Codes und benutzerdefinierte Funktionen in 2.1 Release zu verwenden (und die Nutzung neuer).

Es gibt keine Änderungen in PLUGIN nur. Änderungen werden an anderer Stelle. So lesen Sie das Dokument sorgfältig, bitte.

Für diejenigen, die zu begierig sind, die neue Version ausprobieren oder hate to read "all das Zeug" ist hier das Quick & Dirty PLUGIN Änderung:

Old Jumi PLUGIN

  (jumi [stored_code_source] [arg1] [arg2] ...  [argN]) 

Neue Jumi PLUGIN

  (written_code jumi stored_code_source) (/ jumi) 

How to make Übergang zu Jumi 2,1 Syntax? Wir werden sie erläutert werden. Aber das Wichtigste zuerst.

Beginnen wir mit einigen Erweiterungen insgesamt Jumi Erklärung dann werden wir mit, wie zu aktualisieren und zu installieren fortzusetzen. Am Ende werden Sie gute Kenntnisse darüber erhalten, "all das Zeug."

Die Menge der Jumi Erweiterungen

Jumi 2,1 besteht aus mehreren voneinander abhängigen Erweiterungen:

• Jumi-Plugin (Totally neu geschrieben!)
  ermöglicht, benutzerdefinierte Codes von mehreren Ressourcen in Joomla! Artikel, Inhalte und Beschreibungen Kategorie.
  Sie setzt Jumi Jumi für Root-Komponente und Jumi Modul. Codes sind im PDF-Version von Joomla bearbeitet! Inhalt und entfernt sich von RSS.
  
• Jumi-Editor-XTD (New!)
  ist ein Joomla! Editor Schaltfläche, um Code aktiviert / dekodieren Skripte für ihre direkte Integration in Joomla! Inhalte und die weitere Verarbeitung von Jumi System-Plugin.
• Jumi-Komponente (+ Shared Root Jumi usage)
  erstellt kundenspezifische Joomla! Seiten (so genannte Jumi Applications) mit benutzerdefinierten Code.
• Jumi SEF-Router
  ist ein System-Plugin, das Jumi Komponente unterstützt: Es ermöglicht den direkten Zugriff von Jumi Anwendung mit seinen Alias (zB http://www.mysite.com/hello-jumi).
• Jumi Modul (+ Debug-Modus, + Shared Root Jumi usage)
  ist einfach-Modul zu benutzerdefinierten Codes von mehreren Ressourcen in Joomla aufnehmen können! Modul-Positionen.
• Sprachen
  Ausnahme Jumi Plugin-Router gibt es Sprach-Dateien für alle Jumi Erweiterungen für ihre einfache Übersetzungen.

Jumi 2,1 Anforderungen

Nichts weniger als Joomla! 1.5.8 ist erforderlich.

Upgrade von früheren Versionen

Wir empfehlen, um alle vorangegangenen Jumi Erweiterungen zu deinstallieren und die Jumi 2,1 Paket zu installieren. Betrachten Sie folgendes:

Wenn Sie Ihre alte Komponente Jumi Datenbank-Tabelle in neue Jumi 2,1 dann wieder verwenden, bis der erste Datenbank-Tool Sie verwenden (zB phpMyAdmin). Nach der Installation des neuen Pakets Sie die ursprüngliche Komponente Jumi Datenbanktabelle.

Der alte Jumi PLUGIN wird nicht durch das neue Plugin verarbeitet werden. Sie müssen jede alte Syntax Plugin-Instanz neu zu schreiben. Wir freuen uns sehr leid für die Unannehmlichkeiten wird es mitbringen. Auf der anderen Seite bringt es Ihnen mehr Möglichkeiten, mehr Sicherheit und mehr Flexibilität. Etwas für etwas.

Denken Sie auch daran, dass alle Jumi Module während der Prozess der De-Installation zerstört werden. Also haben wir eine Notiz von Jumi zu empfehlen, alle Module Inhalte zumindest.

Jumi 2,1 Installation

Installieren Sie das Paket als Standard Joomla! Erweiterung. Alle Jumi-Erweiterungen sind in diesem Ein-Klick installiert. Jumi Alle Plugins sind auf "Enable" gesetzt zu.

In Jumi 2,1 gibt es keine Demo Hauptmenü "Hallo Jumi!" Element sichtbar im Frontend wie es in Jumi 2.0. Einige unserer Nutzer hasse es auch als Demo. Wenn Sie es wünschen, haben es sichtbar zu machen manuell: Gehen Sie in das Backend und veröffentlichen die vorinstallierte Menüpunkt "Hallo Jumi!" dort.

Nächste Schritte

Mit Jumi Komponenten-, Modul-und Router könnte von früheren Versionen oder Dokumentationen oder diese cheatsheet abgeleitet werden.

Jumi Plugin erfordert mehr Erklärung. Weil es ein anderes Werkzeug verwendet: Jumi-Editor-XTD (button) Plugin, das encodes-/decodespost benutzerdefinierte Skripts in einer Weise sie nicht von Joomla aus beraubt! und werden von Jumi Plugin verarbeitet.

Im Rest des Artikels werden wir erklären:

1. Wie Codes zu schreiben in der Joomla! Inhalte mit Jumi-Codierer (Code-Name für Jumi-Editor-Plugin xtd).
2. How to edit-Codes in Joomla! Inhalte mit Jumi Coder.
3. Wie alt Jumi PLUGIN Übertragung auf die neue.
4. Jumi Plugin Sicherheit und andere Bemerkungen.

Mit Jumi Coder

Na ja, sehen Sie das Video erste. Wir werden es zu erklären, dass nach.

Wie funktioniert es?

Wissen Sie, wenn Sie benutzerdefinierte Skript in ein Joomla aufzunehmen! Artikel der Code entfernt werden oder, im besten Falle in HTML-Entities codiert.

Und hier kommt Jumi Coder. Es kodiert für Skripts in einer solchen Weise, dass Joomla! und ihren Herausgeber erkennen nicht, dass es einen Code. Allerdings Jumi Plugin erkennt Jumi Syntax und alles zwischen Jumi Tags.

  jumi stored_code_source () Dies ist ein Raum zwischen Tags für Ihre schriftliche code (/ jumi) 

dekodiert und ausgewertet werden kann. Einfach, nicht wahr?

Jumi Coder wurde mit nowysiwyg Editor Tiny MCE, JCE und FCK Editoren erfolgreich getestet. Was gibt's groß ist, dass Sie zwischen Redakteure auf keine Redakteure wechseln können, wie Sie wollen. Jumi Coder nicht von ihnen abhängen.

Also nochmals, wie Sie den Code in Artikel über Jumi Coder enthalten? Lesen Sie mehr zu konsultieren und gleichzeitig das Bild:

1. Schreiben Sie (oder kopieren Sie von einer Quelle) das Skript in den Code-Editor-Bereich.
   
2. Realisieren Sie, wenn Sie od Nowysiwyg Wysiwyg-Editor. Wählen Sie die Codierung entsprechend.
3. Presse Encode.
4. Das Skript ist verschlüsselt, und Sie werden die codierten Ergebnis in der verschlüsselten Code-Bereich zu erhalten. (Wenn Sie einen Fehler gemacht hatte oder habe das Skript in einem anderen Editor für die Art kodiert, drücken Sie einfach Decode und wiederholen).
5. Wählen Sie das Skript sehen Sie in der verschlüsselten Code-Bereich, kopieren Sie sie in die Zwischenablage (STRG + C) und fügen Sie ihn (STRG + V) in Joomla! und zwischen den geschweiften Jumi Tags.

Um ganz sicher, dass Sie verstehen, wollen wir ein weiteres Video zu sehen: wie das Skript, das bereits über Joomla! mit Jumi Coder.

Wir hoffen, es ist klar genug.

So verwenden Jumi Coder für die Einbettung das Skript in Joomla! und für seine Bearbeitung.

Jumi Coder kann für die Einbettung von Script-Codes in Ihre Joomla nicht verwendet werden! Blog zu (z. B. Blogger). Der Code wird nicht verarbeitet werden, sondern werden wie ein Code sichtbar.

Bekannte Probleme: Wenn das Skript "schön" formatiert (mehrere Zeilen, Tabulatoren, etc.), dann nowysiwyg Editor bricht diese Formatierung (ohne die Usability verloren - es wird funktionieren). I (MarHaj) weiß nicht, wie damit umzugehen.

Im WYSIWYG-Editoren nice Formatierung erhalten bleibt.

Es ist klar, dass ohne Jumi-Plugin (installiert und aktiviert) das Skript selbst wird nicht ausgeführt! Jumi-Plugin wurde es zuerst zu dekodieren. Denken Sie daran: Jumi Jumi Plugin-Coder und sind Zwillinge!

Syntax-Übersicht

Die allgemeine Jumi 2,1 Plugin-Syntax ist

  (written_code jumi stored_code_source) (/ jumi) 

wo

• stored_code_source ist eine Datei (PHP, CSS, JS, txt, html, ...) Pfad an der Stelle PLUGIN oder id aufgenommen werden (mit Sternchen ging) von Jumi Komponente Position und
• written_code ist ein Code. HTML, PHP, JS, ot nur ein Text. Wenn PHP-Code dann muss es in PHP Start-und End-Tags eingewickelt werden.
  

Beispiele

Beispiel 1: enthält nur PHP-Datei

  (jumi Plugin / system / jumi / jumi_demo.php) (/ jumi) 

Beispiel 2: unter anderem den ersten Satz von Jumi Bauelemente Datenbanktabelle

  jumi * (1) (/ jumi) 

Beispiel 3: umfasst die erste Platte von Jumi Bauelemente databes Tabelle, die vorangestellt ist (!) Von geschriebenes Skript.

  jumi * (1) <? php echo 'Hallo O \' Harra! ";?> (/ jumi) 

Der Vorrang der Verarbeitung written_code -> stored_code_source hat zwei Gründe haben:

1. es ermöglicht, vor 2,1 Jumi php-Dateien verwenden, die benutzt Argumente mit Jumi Jumi 2,1 Syntax (wir werden später sehen, wie genau),
   
2. Es ist mit anderen Jumi-Erweiterungen kompatibel (component, module): Sie haben genau die gleiche Verarbeitung hat Vorrang.
   

Mehrere Zeilen in geschriebenes Skript

Sie müssen nicht schreiben die schriftliche Skript zwischen jumi Tags in einer Zeile. Mehrere Zeilen sind erlaubt. (Und Kombination von Skript Typ wie gut). Zum Beispiel:

  jumi * (1) 
  <? php 
  echo 'Hallo O \' Harra '; 
  ?> 
  <div> 
  <script language="JavaScript" type="text/javascript"> 
  document.write ( "Ihr Lieblingsgetränk? <br />"); 
  Funktion durch () ( 
  window.alert ( "Thank you!")) 
  </ script> 
  <form> 
  <select name="qq"> 
  <option> Wasser </ option> 
  <option> Milch </ option> 
  <option> Bear </ option> 
  <option> Andere </ option> 
  </ select> 
  <input type="button" value="show" onClick="thanks()"> 
  </ form> 
  <div> 
  (/ jumi) 

Lassen Sie uns jetzt befassen sich mit Jumi PLUGIN Abwärtsinkompatibilitätsproblemen.

Old Jumi PLUGIN Migration

Der alte - pre 2,1 Jumi - Plug-in wurde unter Verwendung der so genannten Argumente Jumi Konzept. Es könnte Argumente (einige Werte) in die Datei aufgenommen Pass noch inbegriffen Jumi Bauelemente Datensatz Element.

In diesem Fall ist die Syntax wurde, als Beispiel, wie dieses:

  (jumi [myfile.php] [edo] [888]) 

Das Argument-Werte (in diesem Fall Anzahl Text "edo" und die Nummer 888) zugänglich war im php sript (myfile.php) über $ jumi []-Array. Wie folgt aus:

  <? php 
  echo $ jumi [0]. $ jumi [1]. "@ gmail.com"; 
  ?> 

Wenn Ihr altes PHP-Skripte verwendet jumi $ []-Array brauchen Sie nicht zu Abfall. Definieren Sie einfach die $ jumi Array in written_code Abschnitt:

  jumi myfile.php () <? php $ jumi = array ( 'edo', 888);?> (/ jumi) 

Und deshalb written_code bevor der Code gespeichert verarbeitet wird.

Wir hoffen, es ist klar, und dies zu ermöglichen, Ihre alten Schriften in 2,1 Plugin-Syntax leicht zu migrieren.

Wenn Sie schreiben die Skripte aus dem Grund auf können Sie in written_code alle Variablen, die Sie in stored_code_source können definieren. Zum Beispiel

  jumi myfile.php () 
  <? php 
  $ name = 'edo'; 
  $ number = 888; 
  ?> 
  (/ jumi) 

Denken Sie daran: jede Variable definieren Sie außerhalb der Funktion oder Klasse wird globalen Variablen. Es ist gut und schlecht.

Es ist gut, weil die Variable von überall zugänglich. Es ist schlimm, weil es mit der Variable mit dem gleichen Namen, der definiert ist (von einem anderen Entwickler) an einem anderen Ort kann interract von Joomla! Seite.

Also, wenn Sie Ihre eigene globale Variablen geben ihnen recht exotischen Namen.

Neue Jumi Plugin Sicherheitsfragen

Wenn Sie mit Joomla! als ein offenes Umfeld, das heißt, es gibt viele Leute, die dazu beitragen könnte, den Inhalt, die Fragen der Sicherheit ihre Werte haben.

Lassen Sie uns für einen Augenblick an ist er oder sie ein Mann, der zu schaden oder Gewinn machen will, für seine eigenen. Wenn der Kerl aktiviert ist, um die Skripts in Ihre Website frei und die Skripte wirklich verarbeitet werden, werden Sie nicht in der Lage, den Kerl aus vollständige Kontrolle über Ihre Website zu verhindern sind. Nicht sehr enoyable Idee, isnt 'it?

Der alte Jumi enthält nur Skripts aus einer Datei oder aus einer Datenbank. Der Eindringling konnte verwenden nur das, was in Ihrem Seite wurde (und er / sie muss den Standort zu erfahren). Aber jetzt, wo direkte Skript Integration ist möglich? Es ist noch einen Kuchen!

Joomla! Entwickler haben die Schwarze Liste eingeführt und Whitelist-Filterung Konzept in Joomla! 1.5.8. Sie können diejenigen, die auf schwarzen Liste sind oder nicht auf der Whitelist zu tun, bestimmte "Dinge" zu verhindern.

Jumi Plugin 2,1 verwendet diese Liste. Wenn der Artikel Autors (oder Gruppe, zu der gehört) ist in der Blacklist oder nicht in der Whitelist dann Jumi Plugin wird nicht verarbeitet den Code (direkt geschrieben oder aus einer Datei oder Datenbank enthalten) und der Code wird nicht in der sichtbaren Front Ende.

Joomla! itselfs Streifen aus den Code aus Artikeln. Jumi Coder, die jedem zur Verfügung steht, wie ein Editor-Button Plugin Skript kodiert sind, dass Joomla! wird nicht klar heraus. Thye-Code wird da sein. Aber werden nicht bearbeitet werden! Es wird nicht verarbeitet werden, auch nach Jumi Plugin deinstalliert wird - das Skript kodiert wir wiederholen.

Also, wenn Ihr Whitelist / Blacklist richtig eingestellt ist, Schrecken Sie nicht zurück. Just be careful.

Parameter "Jumi Default absoluten Pfadnamen", wie Sie es kennen von früheren Versionen ist immer noch da. Jetzt haben wir etwas anderen Namen verwenden, denn es: Jumi Root.

Jumi Root-Parameter ermöglicht den Zugriff auf Skript-Dateien leicht withoyt schriftlich den vollständigen Pfad zu ihnen über und über. Sie können Ihr Skript-Dateien außerhalb Joomla! Root-Verzeichnis zu.

Jumi Root wurde zuvor von den einzelnen Jumi Verlängerung bis unabhängig einstellen. Jetzt gibt es nur an einer Stelle, wo Sie es einrichten können: Jumi-Plugin. Das Setup ist für alle Jumi Verlängerung gültig.

Damit aber jetzt noch nicht

Wir, die Entwickler, wird mir ein Edo (MarHaj), bestätigen jedes Feedback von Ihnen, Jumi Benutzer. Über Jumi selbst oder dieser Dokumentation. Fehlt etwas? Etwas unklar? Etwas funktioniert nicht wie erwartet?

Vielen Dank für Ihre Zeit in einem Voraus!

Jumi (prefarably positive) Feedbacks

Alles andere