Documentație Designer

CushyCMS funcționează prin FTP-uirea în site-ul tău și apoi căutarea claselor CSS specifice aplicate elementelor paginii. În funcție de conținutul găsit, Cushy va prezenta atunci cea mai bună cale de editare a acelui conținut.

Această pagină documentează toate opțiunile template-ului Cushy.

Free Account

Pro Account


Free Account

Privire de Ansamblu

Cushy va edita inteligent orice element în care plasezi clasa css cushycms.

<h1 class="cushycms" title="My Heading">Acesta va deveni editabil</h1>
<div class="cushycms" title="Main Content">
  <p>Mai multe lucruri editabile aici...</p>
</div>
<p>Nu sunt editabil(ă).</p>
<img class="cushycms" src="foo.jpg" alt="Sunt o imagine editabilă!" />

Tip: Pro users can specify a class of "clienteditor" as an alternative to "cushycms".

Dacă elementul are deja un nume al clasei poți aplica în continuare cushycms în el:

<div class="whatever cushycms">

Aici este un video care arată cum să pornești cu CushyCMS în doar câteva minute.

Cum să instalezi și să editezi în 5 minute

Câmpuri Etichetare

Ajută-ți editorii să identifice ce secțiune editează prin aplicarea etichetelor în câmpurile tale. Folosește doar atributul title al elementului editabil.

<h1 class="cushycms" title="Titlu Principal">Acesta va deveni editabil</h1>

Cushy va prelua automagic etichete din următoarele atribute acolo unde e cazul:
title, alt, id

Editare Imagini

Cushy poate permite editorilor tăi să schimbe imaginile dintr-o pagină. Va căuta înălțimea și lățimea în tag-urile imaginilor pentru a redimensiona inteligent fișierul cu pricina.

<img src="1.jpg" class="cushycms" width="250" height="100" alt="Photo" />

Imaginea încărcată va fi redimensionată la o lățime de 250px și o înălțime de 100px. Imaginea va fi de asemenea decupată dacă e necesar.

<img src="1.jpg" class="cushycms" width="250" alt="Photo" />

Imaginea încărcată va fi redimensionată la o lățime de 250px. Înălțimea își va păstra proporția.

<img src="1.jpg" class="cushycms" alt="Photo" />

Imaginea încărcată nu va fi deloc redimensionată.

Încărcare Fișiere

Editorul Cushy WYSIWYG permite utilizatorilor să încarce fișiere locale prin butoanele Link și Imagine (vezi tab-ul Încărcare din fereastra popup).

Inițial aceste fișiere sunt stocate temporar pe server-ul Cushy dar sunt apoi transferate pe server-ul tău FTP după publicarea paginii.

Implicit aceste fișiere sunt publicate în același director cu pagina însă acest lucru se poate schimba din pagina Configurare Site.

Suprascriere Tipuri de Conținut

Cushy folosește metode diferite de editare în funcție de tipul conținutului. Cushy va alege inteligent o metodă bazată pe elementul container. Oricum, ne dăm seama că pot exista situații când vei dori să forțezi un anume tip de conținut. Dacă este cazul folosește una din clasele alternative de mai jos:

class="cushycms-text"

Editează conținut doar ca text simplu. De exemplu: editare cod server-side sau dacă preferi să scrii html manual.

class="cushycms-html"

Orice caracter special introdus va fi schimbat în entități html. Eg: © becomes &copy;

class="cushycms-wysiwyg"

La fel ca mai sus, deși editorul are la dispoziție butoane pentru efectuarea diferitelor sarcini de bază precum crearea de liste, link-uri etc.

class="cushycms-xml"

Orice caracter special introdus va fi schimbat în entități xml. Eg: < becomes &lt;

Elemente XML

Cushy suportă elementele XML. Conținutul introdus în zona de editare pentru elemente XML va fi codat corect XML pentru ca XML-ul tău să nu devină invalid. Orice element întâlnit de Cushy care NU este clasat ca XHTML (lista completă aici) va fi tratat ca XML.

<product>
  <name>Banana</name>
  <price class='cushycms'>$12.99/kg</price>
</product>

Dacă ai probleme cu elementele XML ca fiind identificate XHTML (deoarece au același nume), verifică secțiunea despre suprascrierea tipurilor de conținut. Poți folosi tipul de clasă cushycms-xml pentru a forța elementul tău în modul XML.

Ponturi & Trucuri

Ține minte că nu sunt multe lucruri pe care Cushy nu le poate edita. Mai jos sunt câteva exemple creative:

<script type="text/javascript" class="cushycms">
  alert('Vezi? Poți edita chiar și javascript!');
</script>

Editare javascript. Un exemplu poate fi codul tău Google AdSense.

<p>Our charity has raised $<span class="cushycms">2140</span> so far</p>

Permite editarea doar a unui cuvânt sau expresie.

Folosirea Cushy cu Limbaje Dinamice (PHP, ASP etc.)

Cushy câteodată poate avea dificultăți în descifrarea documentelor atunci când conțin un mix de limbaj precum html și server-side ca PHP.

Din acest motiv insistăm să se plaseze conținut cushy editabil într-un fișier independent static care este apoi inclus în script-urile tale.

De exemplu:

<html>
  <head><title>Contact Us</title></head>
  <body>
    <? include("contact_static.html"); ?>
  </body>
</html>

Mai sus: conținutul contact.php.

<h1 class="cushycms">Contact Us</h1>
<div class"cushycms">
  <p>Conținut editabil aici...</p>
</div>

Mai sus: conținutul content_static.html.

În acest scenariu vei îndruma Cushy către fișierul contact_static.html pentru a-l edita.

Codare Caracter

Cushy redă caractere speciale (precum caractere non-vestice) în formatul versatil UTF-8. Pentru a suporta acest format trebuie să te asiguri că următoarele apar în secțiunea head a paginilor html:

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />

Află detalii despre avantajele UTF-8.

 

Pro Account

Elemente Repetabile

Folosirea elementelor repetabile în CushyCMS poate fi extrem de puternică. Primul pas este amplasarea clasei editabile în elementul repetabil exterior; tag-urile disponibile sunt un <ul>, <ol> <table> și <dl>. De aici, cushy va căuta în acel element și va determina ce elemente sunt "repetabile", de ex. un tag <li>, <tr> sau <dt>. Odată ce acel element este găsit, orice tag-uri editabile din acel element vor fi grupate împreună astfel încât orice "repetare" a elementului exterior să conțină toate elementele editabile în el.

Ia în considerare exemplul următor:

<ul class="cushycms">
  <li>
    <p class="cushycms">Acesta va deveni editabil</p>
    <p>Nu sunt editabil(ă).</p>
  </li>
</ul>

Aici, tag-ul <li> conține un tag editabil <p> și un tag non-editabil <p>. Când editorul alege să "repete" acest <li> CushyCMS va clona tot tag-ul, inclusiv ambele elemente <p>, deși editorul are acces la editarea unui element din ele. Poți avea câte tag-uri editabile dorești în elementul repetabil sau poți face elementul repetabil editabil în întregime.:

Aici este un video care îți arată cum să implementezi o regiune repetabilă.

Regiuni Repetabile

Suprascriere imagini / încărcări

Folosește căsuțele de bifat din pagina de acordat/configurat pentru a activa această caracteristică. Odată activată, orice imagini noi pentru tag-urile CushyCMS <img> vor păstra același nume de fișier. Orice imagini sau fișiere încărcate via editorul WYSIWYG vor păstra numele de fișier pe care l-au avut în timpul încărcării. Această facilitate e utilă pentru lucruri precum listă_prețuri.pdf sau similare și înseamnă că editorul este în deplin control asupra denumirii fișierului pe server. Trebuie să fii atent(ă) în cazul în care editorii tăi încarcă un fișier denumit print.css sau similar care ar putea strica site-ul. Din acest motiv recomandăm folosirea acestei setări atunci când folosești și o adresă de încărcare personalizată.

Clase Personalizate Editabile

Ca utilizator pro poți defini propriile clase editabile în locul claselor trdiționale cushycms sau clienteditor. Poți chiar seta asta per editor. În acest fel poți permite accesul unui editor în anumite secțiuni dintr-o pagină concomitent cu acordarea accesului altui editor în alte secțiuni. Folosește drept exemplu codul de mai jos:

<span class="cushycms-ferris">Only Ferris can edit this.</span>
<span class="cushycms-cameron">Only Cameron can edit this.</span>

Aici poți vedea că cushycms-ferris și cushycms-cameron sunt clase personalizate. Acestea pot fi companiamea-ferris dacă dorești. Poți seta editorilor clase care să se numească doar "companiamea" dacă nu ai nevoie de una din tehnicile complicate de autorizare. Trebuie remarcat că aceste clase funcționează de asemenea cu suprascriere de conținut, astfel încât companiamea-ferris-html va funcționa conform așteptărilor.

Branduire și Stilizare

Aici este un video care îți arată cum să personalizezi CushyCMS cu brand-ul tău sau al clientului tău.

Branding, Stilizare și Clonare

Clonare Pagină

Ca utilizator pro poți permite unor sau tuturor editorilor să creeze pagini noi bazate pe conținut din pagini existente. Poți permite asta când adaugi un editor sau când editezi permisiunile unui editor existent. Prin activarea acestei opțiuni se va activa o icoană de clonă lângă fiecare pagină din panoul de control al editorilor (această icoană este vizibilă designerului paginii). Editorului i se va solicita numele paginii noi și un nume de fișier va fi generat bazat pe acel nume. Noua pagină va fi o clonă exactă a paginii vechi, pe care editorul o poate edita ca de obicei.

Email de Bun Venit Personalizat

Ca utilizator pro poți seta un template pentru emailul de bun venit. Acest lucru se face din preferințele utilizatorului, chiar sub locul unde îți setezi domeniul personalizat și unde poți alege alte caracteristici pro precum branduirea. Există mai multe variabile care vor fi interpolate în email, precum numele editorilor, adresa de email și parola generată de sistem. Evident recomandăm includerea cel puțin a variabilei parolei.

Feed-uri RSS ale Schimbărilor de Pagină

Utilizatori Pro primește feed-uri RSS speciale pentru a fi informat(ă) despre schimbări ale site-urilor și paginilor.

  • Toate schimbările: acest feed e disponibil în pagina implicită a panoului de control
  • Schimbări la un site: acest feed este disponibil din pagina Configurare Site
  • Schimbări la o pagină: acest feed este disponibil din pagina Revizuire Modificări

Orice cititor de feed-uri folosești va fi nevoie să suporte autentificarea deoarece are nevoie de datele cushy de login pentru a afișa feed-urile. Dacă cititorul nu suportă asta (ex. Google Reader) atunci o soluție este serviciul freemyfeed .