Låt oss anta att du har Jumi komponent, plugin och modul installerat och igång i ditt arbete Joomla! miljö.

Du kan börja spela med Jumi nu.

Jag har inte råd att spela med Jumi på din publika levande webbplats - du ska publicera det endast sådana Jumi ansökningar som framgångsrikt testats på din privata (dvs. inte för offentliga ögon) Joomla! installation, företrädesvis på den lokala datorn.

Allmän strategi för att använda Jumi

Bara för att påminna dig:

Jumi gör ingenting men inkluderar (sprutar) din egen kod i Joomla!. Antingen som en separat sida (via Jumi komponent) eller i artiklar (via Jumi plugin) eller i moduler läge (via Jumi modul). Innehållet i din integration - enkelt eller magi - gör vad du ser.

Koden kan lagras i filer som finns på din server eller i ett register över Jumi komponent databastabell eller direkt skrivas in Jumi förlängningar.

Om du väljer att lagra dina koder i php-filer läser Säkerhetsfrågor också.

Den allmänna Jumi användning kan särskilda från följande schema

I den här artikeln kommer du att lära dig att använda Jumi komponent, plugg och en modul respektive

Komponent

Den Jumi komponenten skapar egna Joomla! sida och omfattar i den anpassad kod. Anpassad kod kan direkt skrivas in i komponenten artikel och / eller är "tillbaka" från en tidigare lagrad fil.

Komponenten är tillgänglig via admin backend menyn: Komponenter -> Jumi. Den öppnar Jumi programhanteraren.

Du kommer att se listan av komponenter program i programhanteraren. Innebörden av de kolumner i listan och åtföljs Application Manager-menyn är uppenbart - det respekterar allmän Joomla! standarder.

Det finns två förinstallerade exempel där: "Hej Jumi!" och "Blogspot". Från dessa exempel får du lära dig hur du använder Jumi komponent.

The Sökväg området ska innehålla referenser till de filer som finns på din server bara.

Skript orderhantering

Om du har fyllt både komponent filelds "Custom script" och "sökväg" och sedan på "Anpassad skript" behandlas först.

Ringa Jumi ansökan

Du kan ringa ett program på två sätt:

• avse ett program objekt med Joomla! menyalternativet eller. Efter installationen av komponenten finns, som ett exempel för studien, huvudmenypost "Hej Jumi!" ansluten till "Hej Jumi!" Ansökan post.
• skriva var som helst i Joomla! innehåll länk till det program objektet URL-adress. Regeln för länken skapande är enkel:
  index.php? option = com_jumi & fileid = xxx
  där xxx är ID Jumi ansökan, som kan ses i den högra kolumnen i Jumi programhanteraren lista.

Plugin / mambot

Den Jumi plugin / mambot ingår i Joomla! artiklar eget skript: från en fil eller från Jumi komponent databas rekord.

Innan du använder plugin glöm inte att aktivera det i admin backend.

Det finns en switch "Stop / Clear Jumi Codes" i plugin Advance parametrar. Om bytte till Ja det rensar alla Jumi plugin syntax text i Joomla! artiklar och stannar kod inneslutningar!

Plugin syntax

Den allmänna Jumi plugin syntax kan dras från den Jumi Användande lathund. Vi kommer att sätta bara några exempel här:

{Jumi [bilder / koder / test.php]}-/ ingår test.php filen som ligger i images / koder
{Jumi [* 1]} / / includes kod lagrad i 1: a register över Jumi komponent databastabell
{Jumi område calc [test.php] bredd [4] höjd [6]} / / includes test.php filen och fyller $ jumi array

Från gett exempel kan du enkelt gissa att

1. Det får inte finnas några tecken mellan vänster hakparentes { och nyckelordet jumi i Jumi syntax.
   
2. Allt annat utanför [] parentes är strippad ut och inte bearbetas.
3. Jumi tolkar conent av den första konsolen som koden källa och försöker inkludera det. Koden källa kan vara antingen en fil eller post-ID för Jumi komponent databastabell.
   
4. Början från den andra konsolen [] Jumi lagrar innehållet i parentes till $ jumi array. Den $ jumi array (och det värden) är tillgänglig från ditt ingår PHP-kod.

Argument värden kan vara tal, vanlig text, HTML kodad text, etc. etc. Det kan vara allt med undantag av fästen symboler: [,], {,}.

Om något går fel, är t.ex. ingenting som visas i artikeln, switch "Debugläge" till Ja. Det kommer att visa dig Jumi felmeddelande om detta.

Parameter: Jumi Standard Absolute Path

Default absoluta jumi väg är prepanded till filen sökväg som skall ingå. Om inte, ställ det är eqaul till Joomla! rotkatalog. Till exempel:

Om vi ​​skriver

{Jumi [test.php]}

och Standard Absolute Jumi Sökväg inte är satt så Jumi plugin slår upp test.php i Joomla! root (där Joomla! configuration.php är). Men om vi sätter det vara "images / mycodes" det ser upp i den här katalogen.

Vi kan placera våra filer utanför Joomla! installationskatalogen också. Till exempel (på lokal värd) vi kan ha våra Joomla! här: "D: / xamp / htdocs / Joomla". Inga problem att lagra våra koder här: "D: / xampp / htdocs / koder" - av Joomla! katalog. Detsamma gäller för värd webbplatser.

Default Absolute Jumi Paths har två orsaker:

1. komfort: behöver och om igen skriva hela relativa sökvägen till filer som ska ingå
2. Webbsäkerhet: om vissa grunder Jumi inte fungerar som den Jumi syntax kod är synligt för besökare. Inklusive sökväg. Default Absolute Jumi Path är dold och det är svårare att gueast från synliga kod där koden faktiskt är. Och om filer som ska ingå lögner ur din webbplats (www) är det praktiskt taget omöjligt att nå dem från webbläsare. Se Säkerhetsfrågor för mer information.
   

Default Absolute Jumi Sökväg anger här är den globala parametern för alla Jumi plugin syntax instancies hela Joomla!.

Parameter: Kapslade ersätta

Häckande funktionen tolkar Jumi syntax i inkluderade koder. Till exempel:

Lets har två filer: main.php och nested.php.

Filen innehåller main.php

echo "Detta är den viktigaste filen <br />";
echo "{jumi [nested.php]}";
?>

och nested.php innehåller

echo "Detta är den kapslade script";
?>

Efter att ha båda filerna main.php och nested.php laddade upp på servern vi kan skriva i artikeln

{Jumi [main.php]}

Resultatet vi ser kan vara antingen

Detta är den viktigaste fil
{Jumi [nested.pgp]}

om switchen Kapslade ersätta är inställd på Inga eller

Detta är den viktigaste fil
Detta är den kapslade script

om omkopplaren är inställd på Ja.

Det är tydligt att Kapslade ersätta funktionen innebär för utvecklarna ganska intressanta möjligheter.

De häckande funktionen fungerar i Jumi plugin bara.

Den häckar Funktionen fungerar för filer och koder som lagras i Jumi komponenten databastabell.

Andra plugin parametrar

Om Debugläge är inställt på Ja det kommer visa dig Jumi felmeddelande om detta.

Om Stopp / Rensa Jumi koder växlas till Ja det rensar alla Jumi plugin syntax text i Joomla! artiklar och stannar kod inneslutningar! Det finns ingen Jumi kod och ingen kod utdata från Jumi plugin i Joomla! artiklar.

Modul

Den Jumi modulen ingår i en modul position eget skript: manuellt eller från en fil eller från Jumi komponent databas rekord.

Grundläggande parametrar

Det är bara några grundläggande parametrs i modulen administration där: "Anteckningar", "Code skrivet" och "källa koden".

Anteckningar fungerar som ett område för dina anteckningar.

Kod som skrivits är ett område för din kod.

I fältet Källa till kod Du kan sätta antingen en filepathname av filen som skall ingå i en modul eller * ID för Jumi komponenten Application objektet.

Avancerade parametrar

Jumi Standard Absolut sökväg har exakt samma innebörd som det har i plugin. Med en liten skillnad: den här parametern inte är global för alla Jumi moduler men det kan vara unika för varje Jumi modul instans.

Debugläge har samma innebörd som det har i plugin: Om du väljer Nej då Jumi modulen kommer inte visa några Jumi felmeddelande. Så om du är i svårigheter, är t.ex. ingenting som visas, växla "Debugläge" till Ja.

Andra avancerade parametrar - Modul Klass Suffix, Aktivera cache - Är allmänna Joomla! parametrar som kan hittas i standard Joomla! moduler. Jag antar att deras innebörd är tydlig.

Skript orderhantering

Om du har fyllt både komponent filelds "Code skrivet" och "källa koden" och sedan på "Code skrivet" behandlas först.