Document Actions

Usare i theme in Plone 3 (prima parte)
medio

Lo scopo del manuale è quello di fornire gli strumenti utili a personalizzare lo stile di Plone o creare il proprio theme.

Visualizza tutto in un'unica pagina (utile per la stampa, presentazioni, ecc.)

Introduzione Scopo, prerequisiti e vista d'insieme del manuale più una breve definizione di cosa sia un theme di Plone.
1. Scopo e prerequisiti Introduzione generale al manuale e ai Plone themes, lo scopo è personalizzare il look and feel del proprio sito web Plone.
2. Cos'è un Theme di Plone? Un theme è un insieme di template di pagina, fogli di stile, componenti e configurazioni che contribuiscono a creare il "look and feel" di un sito Plone.
3. Vista d'insieme Prima di iniziare a mettere le mani in pasta, una panoramica su tutti gli argomenti trattati da questo manuale.
Approcci Ci sono diversi modi di affrontare il problema dei theme in Plone. Ti aiuteremo a scegliere l'approccio che preferisci: lavorare via web o sul File System.
1. Partire da zero, o da Plone Default? È anche possibile partire da zero per creare un theme completamente nuovo, ma probabilmente non è necessario.
2. Via Web o su File System? Come decidere se costruire il proprio tema via Web oppure sul File System.
3. Direzioni Future Qual è il futuro dei themes in Plone? Vediamo come la situazione si evolve grazie al continuo lavoro della community.
Strumenti E' ora di mettersi in azione. Per creare Themes in Plone 3 possono esserti utili alcuni strumenti, vediamo quali.
1. Strumenti di scrittura Se lavori su File System, puoi usare un qualsiasi editor di testi per scrivere template, file di configurazione (XML, ZCML) e quel poco di codice Python che serve.
2. Il Debug Mode È difficile che in un nuovo Theme tutto funzioni al volo, quindi è meglio usare il Debug Mode di Plone.
3. Creare un egg del tuo Theme, o un Prodotto Se vuoi lavorare via File System, ecco un tool per creare magicamente uno scheletro della struttura dei file e del codice.
Costruire le diverse parti Skin, Componenti, Configurazione. Le tre principali parti che costituiscono un theme; interconnesse, ma ognuna con un modo diverso di comportarsi.
1. Panoramica generale Una panoramica generale sulle diverse parti che compongono un theme e sul modo in cui interagiscono l'una con l'altra.
  1. Panoramica generale Una panoramica generale sulle diverse parti che compongono un theme e sul modo in cui interagiscono l'una con l'altra.
2. Skin Iniziamo con la prima parte, la skin: template, fogli di stile, file Javascript; come customizzarli, dove trovarli.
  1. I template e TAL (Template Attribute Language) I principali elementi che compongono una skin sono: page template, immagini, script Python, file CSS e file JavaScript.
  2. Dove trovare ciò che ti serve Dove si trova la skin nel tuo sito Plone e in un prodotto che fornisce un theme personalizzato che puoi aver realizzato tu stesso.
  3. Fogli di stile In Plone puoi effettuare consistenti modifiche anche solo sovrascrivendo i fogli di stile già esistenti. Esiste un foglio di stile appositamente creato per questo proposito.
  4. Skin Layers Template, scripts, immagini, CSS e file JavaScript sono organizzati in skin layers. Importante è la priorità tra gli skin layer.
3. Componenti La strutturazione della pagina, viewlet, portlet, e i loro manager. Come creare i propri e dove trovare i pezzi di cui abbiamo bisogno.
  1. Collegare componenti e ZCML Cose da sapere riguardo i component e come essi siano collegati tra di loro
  2. Viewlets, Portlets e Altri Componenti Tipi di componenti: vediamo ora in maniera più approfondita cosa sono le viewlet, le portlet e gli altri componenti.
  3. Personalizzazione o creazione da zero Possiamo creare personalizzazioni attraverso il web, o costruendole su filesystem, così da collegare componenti esistenti con componenti creati ex novo.
  4. Parti dei componenti Maggiori informazioni su come funzionano i componenti: interfacce, classi Python, permessi, dove e come agire.
    1. Le interfacce e la loro importanza Le interfacce sono cose da sviluppatori e rappresentano una fetta importante per collegare differenti componenti. È bene capire cosa fanno e come funzionano.
    2. Classi Python Le classi Python sono spesso coinvolte nel collegamento di differenti componenti; è utile conoscere almeno un po' il loro funzionamento, specialmente se desideri creare viewlets.
    3. Permessi Per limitare la visibilità di un componente è possibile utilizzare l'attributo "permission".
  5. Rendere i componenti specifici per un theme Potresti avere bisogno di creare componenti specifici solo per un particolare theme. Per fare ciò è necessaria un'interfaccia.
  6. Skin o componente? È possibile trasformare in componente qualunque template, file css o directory contenente skin. Quindi perché occuparsi della costruzione tramite skin?
  7. Dove trovare ciò che ti serve Dove mettere i componenti nel proprio prodotto e come ritrovarli nella Zope Management Interface e nel file system.
4. Configurazione Come scrivere un file di configurazione e dove posizionarlo.
  1. Profili Configurazione e profili.
  2. Setup XML Generico Il linguaggio usato per definire i profili.
  3. Lo strumento Generic Setup Lo strumento Generic Setup si trova in portal_setup nella ZMI e si usa per applicare il profilo al proprio sito.
  4. Dove trovare ciò che ti serve Come funziona la configurazione attraverso il web e come rintracciare i file nel filesystem.
Credits Autori e altri dati sul manuale. Il manuale "Usare i theme in Plone 3" è una libera traduzione dall'originale Plone Theme Reference.
1. Credits Autori e altri dati sul manuale. Il manuale "Usare i theme in Plone 3" è una libera traduzione dall'originale Plone Theme Reference.