Clicca QUI
 
homepage opencommercio forum downloads le nostre faq progetti maxdev documentazione accedi al tuo profilo  
Menu Principale
Articoli recenti
Mercoledì 06 Febbraio
·Ecco OpenCommercio MS2.2 RC2a (0)
Venerdì 01 Febbraio
·Rilasciata oscommerce MS2.2 RC2 a (0)
Mercoledì 16 Gennaio
·Rilasciato osCommerce Online Merchant v2.2 RC2 (0)
Martedì 01 Gennaio
·Ecco AutoTheme 0.81 per OPC/OSC MS2.2 RC1 (0)
Venerdì 28 Settembre
·MDPro 1.082 rilasciato (0)
 Articoli vecchi
Categorie

Simple Template System (STS)
Autore contributo: Brian Gallagher @ DiamondSea.com
Email Autore contributo:
brian@diamondsea.com

Se vi piace questo contributo, fate una donazione al team di osCommerce su
 
http://www.oscommerce.com/about/team
Senza il loro incredibile lavoro, non avrei potuto costruire questo. Grazie!

Questo software è pubblicato sotto la licenza Gnu Public, che è incorporata quì
per riferimento:

  http://www.gnu.org/licenses/gpl.txt
-----------------------------------------------------------------------------
Traduzione di Angelo Gagliani
capra@openitalia.net
      per conto di OpenCommercio.com
      
http://www.opencommercio.com
        Brescia, 02 Dicembre 2003
-----------------------------------------------------------------------------

------------------------------------------------------------ -----------------
COSA FA:
-----------------------------------------------------------------------------
Permette di creare semplici templates HTML per personalizzare il layout di OSC.

Basta semplicemente creare una pagina HTML come la desiderate ed inserire le ancòre
per i vari elementi proprio dove li volete vedere.

Per esempio, inserite "$cartbox" dove volete che appaia il blocco del negozio.
Inserite "$categorybox" dove volete che appaiano i blocchi delle categorie.
Inserite "$content" dove volete che appaia il contenuto della pagina principale
(la parte centrale dove compare tutto...), ecc.

Il template fa tutto ciò modificando solo alcuni files in /catalog/includes/,
lasciando inalterati tutti gli altri files, e rendendo così più semplice
l'aggiunta successiva di altri contributi.

-----------------------------------------------------------------------------
CARATTERISTICHE BONUS: Integrazione di un semplice HEADER TAG CONTROLLER
-----------------------------------------------------------------------------
Questo contributo permette anche l'uso del contributo WebMakers.com's
 Header Tag Controller senza dover modificare nessun file del sistema.
Basta copiare i file inclusi in Header Tag Controller al loro posto e
STS li aggiungerà automaticamente in tutte le pagine senza dover modificare
ogni script PHP nella cartella /catalog/.

STS controllerà automaticamente se Header Tag Controller è presente nel sistema 
e in tal caso lo userà.

-----------------------------------------------------------------------------
COME INSTALLARE (Modo semplice):
------------- ----------------------------------------------------------------

Installare una versione pulita di OSC 2.2MS2, eseguire il programma di installazione 
e verificare che tutto funzioni. (se avete aggiunto altri contributi, potrebbe non
funzionare il Metodo Semplice, e dovrete usare il Metodo Avanzato).

Copiare i seguenti files nella cartella /catalog/includes.

application_top.php
header.php
column_left.php
column_right.php
footer.php
application_bottom.php
sts_start_capture.php
sts_stop_capture.php
sts_restart_capture.php
sts_display_output.php
sts_user_code.php
sts_template.html


NOTARE: se usate configure-SAMPLE.php che è incluso nel file ZIP, dovrete reinserire 
tutte le vostre impostazioni di configurazione. E' più semplice aggiungere
le seguenti righe di codice in fondo al vostro file
/catalog/includes/configure.php:

Aggiungere le seguenti righe in /catalog/includes/configure.php. Inserirle prima 
della riga finale con i caratteri di chiusura ?> dello script.

// STS: ADD: Define Simple Template System files
  define('STS_START_CAPTURE', DIR_WS_INCLUDES . 'sts_start_capture.php');
  define('STS_STOP_CAPTURE', DIR_WS_INCLUDES . 'sts_stop_capture.php');
  define('STS_RESTART_CAPTURE', DIR_WS_INCLUDES . 'sts_restart_capture.php');
  define('STS_TEMPLATE', DIR_WS_INCLUDES . 'sts_template.html');
  define('STS_DISPLAY_OUTPUT', DIR_WS_INCLUDES . 'sts_display_output.php');
  define('STS_USER_CODE', DIR_WS_INCLUDES . 'sts_user_code.php');
// STS: EOADD

NOTARE: Non mettere i files nelle cartelle di /admin/. Il contributo funzion a solo 
per la sezione /catalog/.

-----------------------------------------------------------------------------
COME INSTALLARE (METODO AVANZATO):
-----------------------------------------------------------------------------
In ognuno dei seguenti files della cartella /catalog/includes/:

  application_top.php
  header.php
  column_left.php
  column_right.php
  footer.php
  application_bottom.php

dovrete copiare il codice dai files STS nei vostri file originari.

Le modifiche sono precedute da:

  // STS: ADD:

e finiscono con:

  // STS: EOADD

Il modo più semplice per fare le modifiche è sicuramente usando strumenti ad hoc 
disponibili in rete per confrontare e sostituire codice, come il tool grafico che
potete trovare quì:

  http://www.compareandmerge.com/

E' shareware ($35), cioè a pagamento, ma ha una demo pienamente funzionante per 30 giorni.
E' molto comodo se si usa spesso, ma potete anche farne a meno, se lo usereste solo
occasionalmente :-)
Dopo aver fatto le modifiche, copiate i seguenti files:

  sts_start_capture.php
  sts_stop_capture.php
  sts_display_output.php
  sts_template.html

dentro la cartella /catalog/includes/ e controllate se tutto funzioni.

-----------------------------------------------------------------------------
COME USARE:
-----------------------------------------------------------------------------
Modificate il file

 /catalog/includes/sts_template.html

come volete.  Usate le impostazioni degli stylesheeets oppure direttamente l'HTML
per personalizzare il sito e disponete gli elementi come preferite.

Se si vogliono aggiungere ulteriori blocchi nuovi o variabili di template, aggiungerle
anche nel file sts_user_code.php.

-----------------------------------------------------------------------------
CONSIGLI & TRUCCHI:
-----------------------------------------------------------------------------
Un trucco per rendere più semplice il debug (correzione degli errori) dei templates
più semplice, è mettere i link delle immagini e degli stylesheets come percorsi assoluti:
(tipo con http://....) invece che lasciarli relativi.

Questo trucco permette anche di visualizzare la pagina del template direttamente nel
browser esattamente come apparirà anche sul sito, invece di avere quell'odioso
rettangolo bianco al posto dell'immagine mancante già in fase di prova o di dover
successivamente modificare il percorso delle immagini.

Per vedere la pagina template digitare l'indirizzo:

  http://www.tuosito.com/PercorsoCatalogo/includes/sts_template.html

Per visualizzare il tempalte con gli stylesheets, entrate tramite riga di comando
nella cartella /catalog/ e digitate

  ln -s includes/sts_template.html sts_template.html

Verrà creato un link simbolico al file template file nella cartella contenente
il foglio di stile (css).  Poi, utilizzate l'indirizzo

  http://www.tuosito.com/PercorsoCatalogo/sts_template.html

per visualizzare insieme al template anche il foglio di stile.

-----------------------------------------------------------------------------
TAG SUPPORTATI:
-----------------------------------------------------------------------------
Ecco un primo elenco dei Tag supportati (altri verranno inclusi nelle prossime versioni):

$headcontent: Inserite questa variabile all'interno della sezione <­head> per includere
il contenuto dinamico dell'in testazione compreso il javascript nelle pagine che lo
richiederanno. Dovrete purtroppo inserire la variabile $headcontent anche negli <­head>
del codice sorgente delle pagine. Scusate, ma è l'unico modo che siamo riusciti a farlo
funzionare.....

<­!--$headcontent--> : Si può utilizzare questo formato commentato di $headcontent per
evitare di far apparire la parola "$headcontent" nel web editor preferito.

DA NOTARE: non inserite i tags <­title>...<­/title> all'interno dell'header.  Sarà aggiunto
in automatico come contenuto della variabile $headcontent, insieme ai metatags della
Descrizione e le Keywords se avete installato anche il contributo WebMakers.com's Header
Tag Controller.

$cataloglogo: il logo di OSC compreso il link
$urlcataloglogo: URL usato dal logo di $catalog. 
$myaccountlogo: L'immagine del mio Account con link
$urlmyaccountlogo: URL usato dalla funzione Mio Account
$cartlogo: L'immagine del negozio e link
$urlcartlogo: URL usato dalla funzione del Cart
$checkoutlogo: Immagine Checkout e link
$urlcheckoutlogo: URL usato dalla funzione Acquista
$breadcrumbs: I toplink "Top > Catalogo > ecc..."
$myaccount: La versione testuale di "Mio Account" e link.  Cambia in "Logoff" se si è connessi.
$urlmyaccount: URL usata dalla funzione Mio Account.
$cartcontents: Versione testuale della funzione "Contenuto negozio".
$urlcartcontents: URL usato da quest'ultima funzione.
$checkout: Versione testuale della funzione "Acquista".
$urlcheckout: URL usato dalla funzione "Acquista".

$categorybox: Il box Categorie
$manufacturerbox: Il box Produttori
$whatsnewbox: Il box Novità
$searchbox: Il box Cerca
$informationbox: Il box Informazioni
$cartbox: Il box Negozio
$maninfobox: Il box Informazioni produttori (blank se non usato nella pagina)
$orderhistorybox: Il box Cronologia ordini (blank se non usato, p.es. se non connessi)
$bestsellersbox: Box i più venduti
$specialfriendbox: Sia il box offerte speciali sia il box Dillo a un amico
$reviewsbox: Il box Recensioni
$languagebox: Il box Lingue
$currenciesbox: Il box Valute
$content: Il contenuto principale della pagina (al centro della pagina)
$date: La data corrente
$numrequests: The "XXX requests Since DATE" text
$counter: Il contatore delle pagine viste
$footer: Il footer dal file footer.php
$banner: Il banner dal file footer.php

$sid: La stringa della sessione nel formato "SessionIdVarName=WhateverTheSessionIdIs"

 
 
Un altro progetto di MAX s.o.s.
Crediti Powered by MDPro