Jumi användande cheetsheet

Jumi - den uppsättning anpassad kod extensions för Joomla! - Kommer som en komponent, plugg och en modul.

I den här artikeln lär du dig hur man använder dem.

Komponent

Den Jumi komponenten skapar egna Joomla! sidor och omfattar i det anpassade koder från en databas och / eller filer.

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

Du kommer att se listan av komponenter program i programhanteraren. Betydelsen av colums 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 man använder en komponent.

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

Ringa applikationer

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.
• skriver någonstans int Joomla! innehåll länk till det program objektet URL-adress. Regeln för länken skapelse ä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.

Insticksmodulen

Den Jumi plugin 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 "Dölj Jumi kod" i plugin parametrar. Om bytte till Ja det hudar alla Jumi 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 band att inkludera det. Koden källa kan vara antingen en fil eller post i Jumi komponent databas.
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.

Default Absolute Jumi 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.

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

Kapslade ersätta

Häckande funktionen tolkar Jumi syntax i inkluderade kod. 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.

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.

Modul parametrar

Det är bara några parametrar 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

Default Absolute Jumi Path 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.

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

Exempel på

För snabb test modulen arbetar skriva ned i "källa kod"-fältet * 1. Inget annat krävs. Sedan publicera modulen i någon modul position tillgänglig. Du bör se "Hej Jumi!" Demo i modul position (i frontend).