SPIP – redakčný systém

SPIP je redakčný systém pre internet.
Zdá sa vám to povedomé? Pozostáva zo súborov nainštalovaných na internetový server, ktoré vám umožňujú využívať množstvo zautomatizovaných funkcií: správu viacerých používateľov, upravovať vzhľad článkov bez použitia HTML, ľahko meniť štruktúru svojej stránky, atď. Pomocou rovnakej aplikácie, akú používate na prezeranie stránky (Netscape, Microsoft Internet Explorer, Mozilla, Opera a i.) vám SPIP umožňuje vytvárať a aktualizovať svoju stránku vďaka veľmi jednoduchému používateľskému rozhraniu.

Existujú iné redakčné systémy a každý má svoje osobitné charakteristické vlastnosti. Jedným z najznámejších je v súčasnosti phpNuke; má zavedenú dosť pevnú štruktúru pre stránku v podobe portálu s krátkymi článkami. Na druhej strane SPIP je flexibilnejší a orientovaný najmä na vytváranie stránok so štruktúrou ako časopisy: to znamená s rubrikami, podrubrikami (a tak ďalej), kde môžete vkladať články a novinky, ktoré môžu byť doplnené o diskusné fóra.

Prečo SPIP?

SPIP je bezplatný softvér distribuovaný pod licenciou General Public License (GPL). Požiadavky SPIPu pokiaľ ide o softvér a hardvér sú naozaj veľmi skromné a dokonca ich spĺňajú aj niektorí bezplatní poskytovatelia webhostingu (viac podrobností nájdete v Častých otázkach a sprievodcovi inštaláciou – alebo aby sme boli veľmi struční: PHP + MySQL).

SPIP je distribuovaný bezplatne cez stránku: Stiahnutie SPIPu.

Výhodou SPIPu je:

- riadenie stránky typu časopis, to znamená stránka vytvorená z článkov a noviniek vložených do hierarchie rubrík, ktoré sú vložené jedna do druhej. Viac podrobností nájdete v kompletnom zozname funkcií SPIPu,

- úplné oddelenie a zadelenie troch druhov úloh rôznym členom redakcie: grafický dizajn; redakčná činnosť stránky cez posielanie článkov a noviniek a riadenie redakcie (čo zahŕňa organizovanie rubrík, schvaľovanie odoslaných článkov, atď.),

- odbremeňuje webmastera a všetkých členov redakcie od množstva nudných aspektov publikovania na internete, ako aj od toho, aby museli stráviť veľa času získaním špeciálnych technických zručností. Inštaláciu SPIPu vykonáte krok za krokom pomocou jednoduchého rozhrania a keď ju dokončíte, SPIP vám okamžite umožní začať vytvárať svoje vlastné rubriky a články.

SPIP má tieto ďalšie funkcie:

1. Pre redaktorov a administrátorov:

- intuitívne webové rozhranie do veľkej miery pomáha pri odoslaní článkov a noviniek, ako aj pri riadení stránky. Okrem toho množstvo klávesových skratiek umožňuje meniť vzhľad textu bez toho, aby ste museli použiť tagy HTML, čo sprístupňuje upravovanie každému, keďže je také ľahké ako písanie e-mailu,

2. Pre webmastera:

- grafika a navigácia na stránke sú definované pomocou šablón vzhľadu HTML (alebo „master stránok“), pričom každá z nich určuje spôsob zobrazenia nejakého typu stránky (napríklad jedna určuje spôsob zobrazenia úvodnej stránky, iná spôsob zobrazenia rubriky a krátkeho zhrnutia jej obsahu, tretia spôsob zobrazenia podrobností článku, štvrtá určuje spôsob zobrazenia podrobností novinky). Spôsob, akým sa redakčný obsah uloží na tieto stránky, určuje množstvo psedotagov podobných HTML, ktorým sa dá pomerne ľahko porozumieť,

- SPIP neobmedzuje možnosti stránky pokiaľ ide o grafiku a navigáciu. Šablóny HTML si môže webmaster úplne prispôsobiť. So SPIPom sa dá ovládať množstvo prvkov stránky, a to aj pod podmienkou, že niektoré sa budú riadiť manuálne alebo dokonca pomocou iných redakčných systémov (poskytovanie týchto systémov je, samozrejme, také „tolerantné“ ako v prípade SPIPu),

3. Pre návštevníkov stránky:

- systém cache na verejne prístupnej stránke zrýchľuje prezeranie tak, že bráni nadmernému množstvu požiadaviek na databázu, a tak bráni jej zrúteniu (čo sa môže často stávať na preťažených serveroch): v takých prípadoch stránka zostane dostupná, aj keď sa jej obsah nedá upravovať (vrátane príspevkov v diskusnom fóre),

- vyhľadávač a indexovanie integrované v SPIPe, ktoré, ak ich webmaster aktivuje, ponúkajú vyhľadávanie v celom verejne prístupnom obsahu stránky.

Nevýhody

Nateraz z flexibility SPIPu vyplýva pre webmastera potreba kratšieho štúdia, aby vedel zmeniť predvolený vzhľad šablón. Narozdiel od systémov s pevnou štruktúrou ako phpNuke, kde môžete zmeniť farby alebo logo kliknutím tlačidla (ale to je všetko, čo vám taký systém povolí urobiť), webmaster v SPIPe sa potrebuje naučiť len niekoľko základných pseudo-tagov HTML, ktoré, keď ich zvládne, mu umožnia robiť všetko, čo bude chcieť.

SPIP sa dodáva s kompletným rozhraním navigácie; len čo začnete vytvárať nejaký text pre svoju stránku, dá sa zobraziť pomocou predvoleného grafického rozhrania. Okrem toho si webmaster môže vytvoriť svoje vlastné grafické rozhranie, ak chce.

V budúcnosti plánujeme pridať niekoľko sád šablón so vzhľadmi pre SPIP, čo webmasterom umožní použiť takú šablónu, aká je pre nich najvhodnejšia, aby sme minimalizovali ťažkosti s prispôsobovaním šablón. Už teraz je k dispozícií množstvo takých príspevkov ako farebné motívy alebo šablóny.

Príklady z praxe

Najlepším (a historicky prvým) príkladom využitia SPIPu je e-zine (elektronický časopis) uZine2 (na začiatku sa na vytvorenie SPIPu použil kód tejto stránky). Medzi inými stránkami, ktoré fungujú v SPIPe, by sme radi spomenuli anglické vydanie Le Monde Diplomatique a Vacarme.

Čo ďalej

Na to, aby ste sa so SPIPom oboznámili podrobnejšie, sa odporúča, aby ste si prečítali dokumentáciu, príklady a „prvé kroky“ v tejto rubrike. K dispozícii máte aj elektronické konferencie či diskusné skupiny (alebo po anglicky mailing listy), v ktorých môžete nájsť odpovede na svoje otázky alebo tipy. Nateraz dovidenia!

Como definir la función

La función charger() (cargar()) de un formulario XXX (que aparecerá en los esqueletos con #FORMULAIRE_XXX) está definida en el archivo formulaires/xxx.php o en el archivo formulaires/xxx/charger.php. La carpeta formulaires/ puede situarse en la carpeta de un plugin, o en la carpeta de esqueletos, squelettes.

Esta función debe denominarse function formulaires_xxx_charger_dist(). El sufijo _dist permite a un desarrollador redefinir la función para cambiar su comportamiento creando una función function formulaires_xxx_charger()

Los argumentos de la función

La función charger() recibe automáticamente, en el mismo orden, el valor de cada argumento pasado a la baliza #FORMULAIRE_XX. Por ejemplo al escribir

y la función

$arg1 valdrá #ID_ARTICLE, et $arg2 valdrá #ID_RUBRIQUE.

Qué debe hacer la función

La función charger() debe reenviar una tabla de valores por omisión para cada campo de ingreso de un formulario. Esta tabla tiene una doble función:

• declarar la lista de campos ingresados (la lista de los argumentos «name» de los tags html input del formulario)
• dar un valor por omisión a cada campo de ingreso.

Los valores por omisión serán utilizados la primera vez que se muestra el formulario, pero serán luego reemplazados por lo que ingrese el internauta en caso de volver a presentar el formulario luego un error de verificación.

Ejemplo de una función charger()
Veamos un ejemplo

Aquí, la función charger() va a devolver una tabla asociativa con 3 campos 'apellido', 'nombre', 'email' y un valor por omisión para cada uno de ellos.

Incluso si el valor por omisión del campo está vacío, es importante de hacerlo figurar en la tabla que devuelve la función charger(). En efecto, SPIP luego utiliza esta tabla para saber que campos fueron ingresados.

No es necesario proteger el valor de los campos si contienen comillas, por ejemplo: SPIP lo hará automáticamente.

Cada valor de campo será recuperado en el esqueleto de un formulario html con, por ejemplo acá, #ENV{apellido}, #ENV{nombre}, #ENV{email}

Campos particulares

La función charger() puede devolver ciertos valores particulares:

editable
Este valor se utiliza en el esqueleto del formulario para permitir o no el ingreso de datos. Por omisión, luego del procesamiento del formulario, «editable» es falso y el ingreso de datos al formulario no se vuelve a proponer. Sólo un mensaje de éxito se muestra.

Es posible dar un valor a «editable» para manejar las condiciones particulares de activación o no del ingreso de datos en el formulario.

message_ok
El mensaje de éxito, en principio, es devuelto por la función traiter(). No obstante, es posible que sea devuelto por la función charger() en forma derogatoria.

message_erreur
El mensaje de error, en principio, es devuelto por la función traiter(). No obstante, es posible que sea devuelto por la función charger() en forma derogatoria.

action
Este valor indica la URL a la cual se remite (post) el formulario. Por omisión es la URL de la página corriente. Es importante que así sea en el caso general ya que, en caso de error de datos, hay que poder volver a presentar el formulario.

En ciertos casos derogatorios, puede ser útil de modificar esta URL. Esto está reservado a usos muy específicos

_forcer_request
Por omisión, SPIP verifica que el formulario remitido es el correcto, para permitir tener varios formularios del mismo tipo en una página, y sólo procesar el que fue sometido. La verificación está basada en la lista de argumentos pasados a la baliza #FORMULAIRE_XXX.

En ciertos casos, cuando estos argumentos cambian en razón de un ingreso de datos, SPIP puede equivocarse y creer que el ingreso de datoas viene de otro formulario.
Al pasarle true como valor de _forcer_request, le indica que no debe hacer esta verificación y que debe tratar el ingreso de datos en todos los casos.

_action
Si el procesamiento del formulario xxx debe llamar una función del la carpeta actions/ que está protegida por securiser_action(), es posible, indicando el nombre de la acción, que SPI entregue automáticamente el hash de protección correspondiente.

_hidden
El valor de este campo será agregado directamente en el código HTML del formulario generado. Se la utiliza para agregar campos no visibles (input hidden) que deberán ser escritos explícitamente:

_pipeline
Este campo permite solicitar que el resultado del cálculo del formulario pase por el pipeline mencionado permitiendo así su extensión por otros plugins.
Puede ser una simple cadena (string), para la definición del nombre del pipeline :

o una tabla de dos valores, para precisar los argumentos que se entregan al pipeline :

Prefijos u protección de los campos de ingreso de datos
Por omisión, todos los valores de la tabla están protegidos para poder insertar en toda seguridad en un atributo value de un input en el esqueleto del formulario. Cuando el valor es a su vez una tabla, cada uno de sus valores está protegido, y así recursivamente.

No obstante, los campos prefijados por un _ (underscore) no serán protegidos automáticamente por SPIP. Cuando es necesario pasar valores a un esqueleto , pero que no serán utilizados para el ingreso de datos, se aconseja utilizar sistemáticamente este prefijo.

A la inversa, no se fdebe utilizar un prefijo _ (underscore) para un campo de ingreso de datos, ya que se ignora el valor ingresado por el visitante cuando se vuelve a presentar el formulario en caso de error.

Personalización

Una función charger() de un formulario existente puede ser personalizada por dos mecanismos:

Sobrecarga
Como indicado más arriba, es posible redefinir la función charger() por omisión, definiendo una función propia function formulaires_xxx_charger() que será llamada en lugar de la función por oomisión que comprende el sufijo _dist. Esta sobrecarga podrá situarse en el archivo formulaires/xxx/charger.php, o en un archivo options.php que siempre se carga.

Pipeline
El pipeline formulaire_charger permite modificar el resultado de la función charger() por omisión de cualquier formulario CVT.

Es el método que hay que privilegiar en un plugin.

El pipeline recibe en argumento una tabla de la forma:

Escribiendo la función pipeline de la manera siguiente:

su argumento comprenderá los elementos siguientes:

Todos los formularios pasan por el mismo pipeline. Por ende se debe probar el valor de $flux['args']['form'] para modificar sólo el comportamiento del formulario que nos concierne.

Ver también las funciones verifier() y traiter()

SPIP 2.1.12
(16. November 2011)

Po stiahnutí tohto zazipovaného súboru do počítača treba rozbaliť všetky súbory a nahrať ich – pomocou FTP – na vašu stránku.

Stiahnuť

Automatická inštalácia

Nájdite kópiu súboru spip_loader.php (odkaz nižšie) a skopírujte ho späť do priečinka, kde chcete nainštalovať SPIP (napr. do koreňového priečinka svojej webovej stránky).

Stiahnuť

Potom tento súbor otvorte tento súbor vo svojom prehliadači a počkajte, až kým sa nahrávanie SPIPu úplne nedokončí.

Ak to nebude fungovať, prejdite na manuálnu inštaláciu pomocou archívu ZIP, ktorý sa nachádza vyššie.

Upgrade na verziu 2.x

Ak si sťahujete túto najnovšiu verziu, aby ste upgradeovali verziu na existujúcej stránku a vaša verzia SPIPu je staršia ako 2.0, určite si prečítajte tento dokument, pretože kroky upgradeu, ktoré urobíte, musia zohľadniť veľkú zmenu kódu vo vydaní 2.0.

Verzia vo vývoji

SPIP sa vyvíja cez SVN. Pozor: v súčasnej verzii vo vývoji môžu byť opravené niektoré chyby, ale môže byť aj úplne zbytočná.

Stiahnuť

Projekt vývoja SPIPu má teraz svoju vlastnú webovú stránku: http://core.spip.org/. Ponúka:

Archívy

Tu môžete nájsť staršie verzie SPIPu.

Šablóny, filtre a ostatné nástroje...

SPIP Contrib je referenčná webová stránka používateľov SPIPu. Tu môžete nájsť skoro všetko, na čo si pomyslíte: tipy, šablóny, postupy, atď. Budeme veľmi radi, ak sa podelíte so svojimi vlastnými objavmi ohľadom SPIPu a príspevkami k vývoju SPIPu.

Je veľa používateľov SPIPu, ktorí používajú Dreamweaver (od firmy Macromedia) na úpravu šablón kvôli vzhľadu a formátovaniu obsahu svojich webových stránok. Takéto rozhodnutie sa dá zdôvodniť tým, že Dreamweaver vám umožňuje pracovať v grafickom režime (WYSIWYG) a zároveň mať okamžite prístup k zdrojovému kódu (čo je dôležitá podmienka pre správnu manipuláciu so šablónami).

Rovnako má však Dreamweaver aj nepeknú tendenciu upravovať kód šablóny a narúšať správne fungovanie cyklov. V skutočnosti špeciálne kódy tagov SPIPu Dreamweaver nerozoznáva ako kódy HTML, a tak sa ich snaží automaticky opraviť, čo bráni tomu, aby fungovali tak, ako ste plánovali (vypíše sa hlásenie o chybe, ako: "chýba uzatvárací tag").

Riešením je jednoducho zabrániť Dreamweaveru, aby zdrojový kód opravoval sám:

- v menu "Edit" (Upraviť), vyberte "Preferences" (Predvoľby, nastavenia...),

- vyberte kartu "Code rewriting" (Prepísanie kódu) a odznačte všetky možnosti.

Keď to urobíte, Dreamweaver by sa nemal pokúšať upravovať váš zdrojový kód bez vášho vedomia.

A tu je ďalší "tip", ako donútiť Dreamweaver, aby kódy SPIPu zobrazoval správne:

Do priečinka ...../dreamweaver/configuration/ThirdPartyTags vložte:
- dva obrázky s názvom SPIP.gif (napríklad redacteurs-off.gif a redacteurs-on.gif)
- súbor s názvom spip.xml,ktorý obsahuje tento text:

Tagy SPIPu budú potom nahrádzať obrázky, ktoré ste tam dali, a tagy sa budú dať upravovať v poli "object properties" (=vlastnosti objektu).

Napriek jeho viacjazyčnému používateľskému rozhraniu, on-line pomocníkovi a funkciám na riadenie článkov, existujú v SPIPe niektoré prvky, ktoré sú závislé od jeho "rodného jazyka", francúzštiny. Schéma databáz, názvy súborov a jazyk šablón sú takými prvkami.

Dokonca aj keď vôbec nehovoríte po francúzsky, môžete využívať všetky funkcie, ktoré SPIP ponúka. Tento slovník poskytuje preklad kľúčových termínov.

Filtre sú tiež vo francúzštine a ich kompletný zoznam je dostupný na stránke Filtre SPIPu

Krátky slovník termínov pre zátvorky a úvodzovky

Tag #VAL akceptuje parameter, ktorý sa vráti nezmenený.

Napríklad umožňuje použiť filtre na konštanty.

Napríklad [(#VAL{<:chaine_de_langue:>}|image_typo)] (čo je ekvivalentné k <:chaine_de_langue|image_typo:>)

alebo

Ak chcete používať nejaký súbor so štýlmi (.css) v určitý deň v týždni, môžete postupovať takto:

Súbory so štýlmi sú pomenované jour_0.css až jour_6.css (t. j. den_nedela.css až den_sobota.css)

Tag #AIDER{} (od verzie SPIP 2.0) sa používa na zobrazenie ikony pomocníka vo vašich vlastných šablónach.

#EXTENSION (od verzie SPIP 2.0) zobrazí príponu aktuálneho súboru, napr. pdf, jpeg, mov, ra, a pod.

- #FORMULAIRE_FORUM vytvorí a zobrazí formulár na odoslanie správy ako reakcie na článok. Ak chcete viac informácií, prečítajte si celý článok o formulároch.

Tag #EDITABLE, ktorý sa používa v súboroch šablón, ktoré obsahujú formuláre CVT, uvádza, či návštevník stránky musí zadať údaje do formulára.

Po otestovaní hodnoty tagu šablóna môže schovať časť formulára na zadávanie údajov, keď je vyvolaná po overení.

Pomocou príkladu z Formulaires CVT par l'exemple:

[

(#ENV*{message_ok})

]
[

(#ENV*{message_erreur})

]
[(#EDITABLE|oui)

#ACTION_FORMULAIRE{#ENV{action}}
Vaša e-mailová adresa
[(#ENV**{erreurs}|table_valeur{email})]



Vaša správa
[(#ENV**{erreurs}|table_valeur{message})]
#ENV{message}

]

Ak boli údaje od používateľa spracované, potom ho možno takto informovať:
- ak je tam chyba, zobrazí sa,
- ak sa návštevník nachádza v režime zadávania údajov, zobrazí sa HTML formulár.