pd_scripting - a CMSimple_XH - Plugin

Version: 2.0
©2010 by Holger Irmler http://www.HolgerIrmler.de/playground

@doku_version: 2010-04-02

Tento plugin je zadarmo v rámci Vašej vlastnej stránky, bez ohľadu na to, či je to stránka «komerčná» alebo nie. 
Profesionálni web-dizajnéri, ktorí ho mienite používať aj na ďalších stránkych ako súčasť Vašej ponuky, mali by ste byť féroví a  poskytnúť malý príspevok.

V každom prípade, ak sa Vám plugin páči, môžete zvážiť, či mi nepošlete pár drobných pomocou PayPal.

O plugine

Plugin robí presne to, čo stojí v jeho názve, spravuje príkazy pluginov alebo skriptov spolu s pagedata.php - databázou CMSimple_XH.
Takže už nemusíte písať príkazy pluginov alebo skriptov priamo do obsahu stránky (content.htm).

Účel:

 

 

Inštalácia

Potrebujete CMSimple(_XH) inštaláciu >= v. 1.0 a/alebo  pluginloader >= version 2.1, aby ste s týmto pluginom mohli pracovať.

  1. Urobte si zálohu Vašich súborov!
    Vždy sa oplatí urobiť si zálohu prv, než začnete niečo v systéme meniť.
  2. Stiahnite si plugin, rozbaľte ho a zachovajte jeho adresárovú štruktúru.
    Nové verzie nájdete vždy na http://www.HolgerIrmler.de/playground
  3. Celý adresár "hi_pd_scripting" s celým jeho obsahom uploadujte do adresára [plugins].
  4. Prihláste sa na stránku.
    V správcovskom prostredí nad editorom nájdete novú záložku "Pluginy a skripty".
  5. Ak chcete so stránkou pracovať on-line a mať aj prístup do konfigurácie pluginu, musíte nastaviť právo zápisu do adresárov:

Konfigurácia

Poznámka: Plugin pozná dva režimy:
štandardne sa dá na každú stránku umiestniť iba jeden príkaz/funkcie (spravidla na koniec stránky).
V 'advanced_mode' - podľa nastavenia v konfigurácii  - môže plugin vložiť na jednu stránku až 5 príkazov/funkcií.
toto obmedzenie je zvolené v záujme zachovania čistoty súboru pagedata.php).

Ak chcete meniť konfiguráciu pluginu, vyberte "Hi_pd_scripting" zo zoznamu nainštalovaných pluginov a zvoľte "Konfigurácia".
 

Poznámka: jednoduchá návody nájdete pod značkou "?".

Možnosti konfigurácie:

Nastavenie Prípustné
hodnoty
Popis
destroy all fields: prázne toto nastavenie zatiaľ nie je funkčné
mode advanced: 1 / 0 alebo prázdne Nastavením 1 aktivujete 'advanced-mode'. Majte na pamäti maximálny možný počet príkazov na stránke. Snažte sa ich na stránku umiestňovať čo najmenej.
scripts max on page: 1 ... 5 Uveďte tu max. počet príkazov/skriptov na stránke (1 - 5). Toto nastavenie je funkčné iba v 'advanced-mode' a uloží sa v (and saved in config) inak sa použije štandardné nastavenie 1.
tab hide from user: 1 / 0 or empty Nastevním 1 ukryjete záložku v admin-mode.

Použitie

1. Skripty & Pluginy
Ak chcete priadť na stránku funkciu pluginu, php-kód alebo funkciu CMSimple, zvoľte záložku "Pluginy a skripty"a vyplňte potrebné údaje.
Do poľa "Kód skriptu" píšte iba funkciu CMSimple alebo pluginu.
 

Príklad:
Ak kód, ktorý chcete použiť je napr.:
#CMSimple $output.= pluginname(parameters);#
do poľa "Kód skriptu" napíšete iba
pluginname(parameters)

2. Premenné
Od verzie 2.0 je tiež možné meniť alebo definovať vlastné premenné (napr.  nastavenie jazyka, zmenu configurácie počas behu stránky).
 

Príklad:
Ak napr. chcete zmeniť nadpis "Submenu" na konkrétnej stránke, možete ho na nej (v poli "Kód skriptu") predefinovať napr. takto:
$tx['submenu']['heading']="read more...";

Poznámka: V jednom poli môžete spojiť aj niekoľko výrazov:
$tx['submenu']['heading']="read more...";$tx['menu']['mailform']="Contact me by email";
Dbajte však na správnu PHP-syntax a nezabudnite na zakončovaciu značku ";" !
Umiestňovacie značky sú v takomto prípade ignorované.

1. Normal Mode

Na koniec každej stránky môžete vložiť jeden príkaz/funkciu/skript.

Vložte ho do poľa "Kód skriptu" a zvoľte "áno" pre aktiváciu skriptu počas chodu stránky.
2. Advanced Mode

Na koniec každej stránky môžete vložiť max. 5 príkazov/funkcií/skriptov.

Vložte ich do poľa "Kód skriptu" a zvoľte "áno" pre aktiváciu skriptu počas chodu stránky.
 

Podľa uváženia možete definovať aj "značku" pre umiestnenie príkazu/funkcie/skriptu v poli "Značka v obsahu (nepovinné)".
Značka umiestnená v obsahu stránky bude pluginom nahradená príslušným príkazom/funkciou/skriptom.

Poznámka: Pre vytvorenie značky vždy zvoľte jedinčné znakové reťazce alebo špeciálne znaky!

Ak plugin nenájde definovanú značku, v správcovskom prostredí sa objaví upozornenie. V takomto prípade sa výstup príkazu/funkcie/skriptu umiestni na koniec stránky.

 

Obmedzenia

Tento skript dokáže pracovať takmer so všetkými pluginmi pre CMSimple. Niektoré pluginy však vyžadujú svoje funkcie výhradne v obsahu stránky (napr. Gallery Plugin od Svarrera). Tento plugin hľadá definície galérií priamo v content.htm.
Túto galériu môžete zatiaľ vkladať iba v správcovskom režime. Inak ich plugin nenájde.
(pracujem však na tom ;-) ).

Podpora

Podporu získate na http://www.cmsimpleforum.com

Changelog:

Version 1.0

Version 1.01

Version 2.0

Licencia

Na plugin sa vzťahuje licencia GPL3.
Prosím, neodstraňujte komentáre a odkazy na autorov v kódoch alebo výstupoch.Prosím neodstraňujte z kódu, ani jeho výstupov vložené komentáre a odkazy na autorov.

THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.