Lad os antage, at du har Jumi komponent, plugin og modul installeret og kører i dit arbejde Joomla! miljø.

Du kan begynde at spille med Jumi nu.

Jeg er ikke råd spille med Jumi på din offentlige levende hjemmeside - du skal udgive der kun sådan Jumi ansøgninger, der blev afprøvet med succes på din private (dvs. ikke til offentlig øjne) Joomla! installation, helst på din lokale computer.

Generel strategi for at bruge Jumi

Blot for at minde dig om:

Jumi ikke noget, men omfatter (sprøjter) brugerdefinerede kode i Joomla!. Enten som en separat side (via Jumi komponent) eller i artikler (via Jumi plugin) eller i moduler position (via Jumi modul). Indholdet af din optagelse - simple eller magi - gør hvad du ser.

Koden kan lagres i filer, der findes på din server eller i et referat af Jumi komponent database tabel eller direkte skrevet ind Jumi udvidelser.

Hvis du beslutter dig for at gemme dine koder i php filer læser Sikkerhedsspørgsmål også.

De generelle Jumi brug, kan afsættes fra følgende skema

I denne artikel vil du lære at bruge Jumi komponent, plugin og et modul henholdsvis

Komponent

Den Jumi komponent skaber tilpassede Joomla! side og omfatter i det brugerdefinerede kode. Brugerdefineret kode kan direkte skrives ind i komponenten styk-og / eller er "trukket" fra en tidligere gemt fil.

Komponenten er tilgængelig via admin backend topmenuen: Komponenter -> Jumi. Det åbner Jumi Application Manager.

Du vil se en liste over komponent applikationer i Application Manager. Betydninger af de colums i listen og som er ledsaget Application Manager menu er indlysende - det respekterer almindelige Joomla! standarder.

Der er to forudinstallerede eksempler der: "Hello Jumi!" og "Blogspot". Af disse eksempler vil du lære hvordan du bruger Jumi komponent.

Den Sti område bør indeholde henvisninger til de filer, der ligger på din server kun.

Scripts ordrebehandling

Hvis du har udfyldt både komponent filelds "Custom script" og "sti" så "Custom script" behandles først.

Opkald Jumi ansøgning

Du kan ringe til en ansøgning af to måder:

• vedrører en ansøgning post med Joomla! menupunkt eller. Efter installationen af ​​komponenten er der, som et eksempel for undersøgelsen, vigtigste menupunkt "Hello Jumi!" forbundet til "Hello Jumi!" Ansøgning element.
• skrive hvor som helst i Joomla! indhold til den Application elementet URL-adresse. Reglen for link skabelse er enkel:
  index.php? option = com_jumi & fileid = xxx
  hvor xxx er ID af Jumi program, som kan ses i højre kolonne af Jumi Application Manager liste.

Plugin / programudvidelser

Den Jumi plugin / programudvidelser omfatter i Joomla! artikler brugerdefinerede script: fra en fil eller fra Jumi komponent database rekord.

Før du bruger plugin glem ikke at aktivere det i admin backend.

Der er en switch "Stop / Clear Jumi koder" i den stik Advance parametre. Hvis skiftet til Ja det rydder alle Jumi plugin syntaks tekst i Joomla! artikler og stopper kode inklusioner!

Plugin syntaks

Den generelle Jumi plugin syntaks kan læres fra Jumi Usage Snydeskema. Vi vil bringe bare flere eksempler her:

{Jumi [images / koder / test.php]} / / includes test.php fil placeret i billeder / koder
{Jumi [* 1]} / / indeholder kode gemt i 1. registrering af Jumi komponent database tabel
{Jumi område calc [test.php] bredde [4] højde [6]} / / includes test.php fil og fylder $ jumi array

Fra givne eksempler kan du nemt gætte på, at

1. Der må ikke være nogen tegn mellem venstre beslag { og nøgleordet jumi i Jumi syntaks.
   
2. Alt andet uden for [] parentes er strippet ud og ikke er forarbejdet.
3. Jumi fortolker conent den første konsol som koden kilde og forsøger at medtage det. Koden kilde kan enten være en fil eller registrere ID på Jumi komponent database tabel.
   
4. Startende fra den anden beslaget [] Jumi gemmer indholdet af parenteser i $ jumi array. De $ jumi array (og det værdier) er tilgængelig fra dine inkluderede php kode.

Argument værdier kan være tal, almindelig tekst, html kodet tekst osv. osv. Det kan være alt med en undtagelse af parenteser symboler: [,], {,}.

Hvis noget går galt, er f.eks intet vist i artiklen, skal du skifte "Debug mode" til Ja. Det vil vise dig Jumi fejlmeddelelse, hvis til stede.

Parameter: Jumi Standard Absolute Path

Standard absolutte jumi sti er prepanded til filen sti, der skal indgå. Hvis ikke der er det eqaul til Joomla! rodmappe. For eksempel:

Hvis vi skriver

{Jumi [test.php]}

og Standard Absolute Jumi Sti er ikke sat så Jumi plugin ser op test.php i Joomla! root (hvor Joomla! configuration.php er). Men hvis vi sætter det at være "billeder / mycodes" det ser det op i denne mappe.

Vi kan placere vores filer uden Joomla! installation bibliotek også. For eksempel (på den lokale vært) kan vi have vores Joomla! her: "D: / xamp / htdocs / joomla". Ikke noget problem at opbevare vores koder her: "D: / xampp / htdocs / kode" - ud af Joomla! installation bibliotek. Det samme gælder for hostede websteder.

Standard Absolute Jumi Stier har fået to grunde:

1. brugerkomfort: ikke behov for igen og igen skriver den fulde relativ sti til filer, der skal indgå
2. Web Security: hvis det af bestemte grunde Jumi er ikke i orden at de Jumi syntaksen kode er synligt for besøgende. Herunder filsti. Standard Absolute Jumi Path er skjult, og det er vanskeligere at gueast fra synlige kode, hvor koden egentlig er. Og hvis filerne for optagelse ligger ud af dit websted (www) er det praktisk umuligt at nå dem fra web-browsere. Se Sikkerhedsspørgsmål for flere detaljer.
   

Standard Absolute Jumi Sti indstilles her er den globale parameter for alle Jumi plugin syntaks instancies hele Joomla!.

Parameter: Indskudt erstatte

Nesting funktion fortolker Jumi syntaks i inkluderet koder. For eksempel:

Lets have to filer: main.php og nested.php.

Filen main.php indeholder

<? Php
echo "Dette er den vigtigste fil <br />";
echo "{jumi [nested.php]}";
?>

og nested.php indeholder

<? Php
echo "Dette er indlejret script";
?>

Der begge filer main.php og nested.php uploadet på serveren, vi kan skrive ind i artiklen

{Jumi [main.php]}

Det resultat, vi ser, kan være enten

Dette er den vigtigste fil
{Jumi [nested.pgp]}

hvis kontakten Indskudt erstatte er indstillet til Ingen eller

Dette er den vigtigste fil
Dette er den indlejrede script

i tilfælde af kontakten er indstillet til Ja.

Det er klart, at Indskudt erstatte funktionen giver for udviklerne ganske interessante muligheder.

Den yngler Funktionen fungerer i Jumi plugin alene.

De rugende funktionen virker for filer og koder gemt i Jumi komponent database tabel.

Andre plugin parametre

Hvis Debug mode er sat til Ja, det vil vise dig Jumi fejlmeddelelse, hvis til stede.

Hvis Stop / Clear Jumi Koder er slået til Ja det rydder alle Jumi plugin syntaks tekst i Joomla! artikler og stopper kode inklusioner! Der er ingen Jumi kode og ingen kode output fra Jumi plugin i Joomla! artikler.

Modul

Den Jumi Modulet indeholder i en modul position brugerdefineret script: manuelt eller fra en fil eller fra Jumi komponent database rekord.

Grundparametre

Der er bare nogle få Basic parametrs i modulet administrationen der: "Notesblok", "Kode skrevet" og "Kilde kode".

Notesblok fungerer som et område til dine noter.

Kode skrevet er et område for din kode.

Ind i feltet Kilde kode du kan sætte enten en filepathname af filen, der skal indgå i et modul eller * id af Jumi komponent Application element.

Avancerede parametre

Jumi Standard absolutte sti har nøjagtig samme betydning som det har i den stik. Med en lille forskel: denne parameter er ikke globale for alle Jumi moduler, men det kan være unikke for hver Jumi modul instans.

Debug mode har samme betydning som det har i den stik: når den er indstillet til Nej så Jumi modul vil ikke vise nogen Jumi fejlmeddelelse. Så hvis du er i problemer, er f.eks intet vist, switch "Debug mode" til Ja.

Andre avancerede parametre - Modul Class Suffix, Aktiver cache - Er generelle Joomla! parametre, der kan findes i standard Joomla! moduler. Jeg formoder, deres betydning er klar.

Scripts ordrebehandling

Hvis du har udfyldt både komponent filelds "Code skrevet" og "Kilde kode" og derefter på "Code skrevet" behandles først.