• User

    ecco la spiegazione
    io ci sono riuscito
    segui bene e funziona
    Simple Template System (STS)
    Autore contributo: Brian Gallagher @ DiamondSea.com
    Email Autore contributo: [email][email protected][/email]

    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 [email][email protected][/email]
    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 funziona 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'intestazione 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: Either the Specials box or the Tell A Friend box (depending on page viewed)
    $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"

    $urlcat_Category_Name: The URL to link to the category name. Spaces in the category name must
    be replaced with underscores. For example, for a link the category "Video Cards" you would
    user the template variable

    $urlcat_Video_cards 
    

    The variable names are case insensitive, so you can use upper and lower case however you like.

    $urlcat_x_y_z: The URL to link to the category by cPath string. You can use this to link to a
    category by the numeric values of the categories as shown by the "cPath" variable in the URL.
    The benefit of this is that it will still work if you change the names of the categories, which
    would break the $urlcat_Category_Name format.

    $cat_Category_Name: Same as $urlcat_Category_Name
    $cat_x_y_z: Same as $urlcat_x_y_z


    DEBUGGING: CONTROLLO ERRORI

    Nel file /catalog/includes/sts_display_output.php you can see the
    following settings (near the top of the file):

    $display_template_output = 1;
    $display_normal_output = 0;
    $display_debugging_output = 0;

    Display_Template_Output (the default setting) will cause it to display the
    template versions of the pages.

    Display_Normal_Output will cause it to display the non-template version of
    the pages.

    Display_Debugging_Output will cause it to display debugging information
    showing all of the blocks of data that it is using and how it translates
    them into template variables.

    You can use any or all of the settings in any combination. If you have both
    Normal and Template output, the Template output will be displayed first.


    DEBUGGING IN REMOTO:

    You can toggle the debugging options via URL options. You can use the
    following parameters in your URL to turn on/off options from your browser

    sts_template=1 Turns on the Template display
    sts_template=0 Turns off the Template display
    sts_normal=1 Turns on the Normal display
    sts_normal=0 Turns off the Normal display
    sts_debug=1 Turns on the Debugging display
    sts_debug=0 Turns off the Debugging display
    sts_version=1 Turns on Version Number display
    sts_version=0 Turns off Version Number display


    SUPPORT:

    For support, please post to the Simple Template System thread here:

    http://forums.oscommerce.com/index.php?showtopic=58541


  • User Newbie

    Ciao a tutti sono un nuovo utente ho installato oscommerce 2.2 rc1 + sts ma non rieco ha capire se c'è un tag che mi visualizza solo il totale del carrello.


  • User Newbie

    ciao a tutti....sono un neofita ed ho anche io un problema tra oscommerce e sts...
    sono riuscito ad installare tutto correttamente ma andando nel pannello di amministrazione non mi permette di abilitare STS..come mai?? è capitato a qualcuno??
    grazie


  • User Attivo

    Accipicchia quanti "novizi" di Osc , complimenti !

    Simple Template System, ne ho sempre sentito parlare ma mai usata... dà problemi ?


  • User

    @Tomcat said:

    Accipicchia quanti "novizi" di Osc , complimenti !

    Simple Template System, ne ho sempre sentito parlare ma mai usata... dà problemi ?

    :giggle: non ci crederai... lo sto guardando perfino io, che ho sempre lavorato solo in html!!!!


  • User Attivo

    @Giardino.it said:

    :giggle: non ci crederai... lo sto guardando perfino io, che ho sempre lavorato solo in html!!!!

    occhio che poi ti prende... giuro che oggi ho fatto 10 ore di coding :yuppi:


  • User Newbie

    @Tomcat said:

    occhio che poi ti prende... giuro che oggi ho fatto 10 ore di coding :yuppi:

    ..è vero...da quando ho cominciato a guardarlo..il tempo vola...

    Cmq a nessuno è capitato il mio problema?
    Rispiego...nel pannello di amministrazione di OsCommerce, vado in moduli e su STS..lo installo...e nel modulo default seleziono true per usare STS..salvo le modifiche..e...lo stato ritorna su false..quindi non si abilita..perchè??Uff..:x


  • User Attivo

    Mhhhh... prova a cambiare il valore da false a true direttamente dal database collegandoti con phpmyadmin


  • User Newbie

    @Tomcat said:

    Mhhhh... prova a cambiare il valore da false a true direttamente dal database collegandoti con phpmyadmin

    emh...sono andato a controllare e tabelle particolari non ne ho viste...
    domanda: ma perchè STS salva qualcosa nel database?
    sei si..sai in quale tabella salva queste informazioni STS??
    Grazie


  • User Attivo

    @HuGoLiNo said:

    emh...sono andato a controllare e tabelle particolari non ne ho viste...
    domanda: ma perchè STS salva qualcosa nel database?
    sei si..sai in quale tabella salva queste informazioni STS??
    Grazie

    beh.. l'hai detto tu che è nel DB. Se non altro l'attivazione o meno è data da uno switch nel database (probabilmente tabella configuration). Controlla meglio


  • User Newbie

    Scusami Tomcat...ma nn mi sono fatto capire...

    il falg true/false che ho nominato non si trova nel database..ma io lo modifico dal pannello di amministrazione di Osc...è da li ke attivando il radio button su true, non mi si salva lo stato...

    ..allego screenshoot per ulterire chiarezza..

    Grazie ancora!!


  • User Attivo

    @HuGoLiNo said:

    Scusami Tomcat...ma nn mi sono fatto capire...

    il falg true/false che ho nominato non si trova nel database..ma io lo modifico dal pannello di amministrazione di Osc...è da li ke attivando il radio button su true, non mi si salva lo stato...

    ..allego screenshoot per ulterire chiarezza..

    Grazie ancora!!
    :giggle: ... ma secondo te il valore 'true' o 'false' dove lo scrive materialmente nell'etere ? Tutti i valori che vedi in admin sono scritti in tabelle del DB (generalmente 'configuration' , ma anche altre).

    Trova la key che corrisponde a quel setting e prova a cambiare a mano dal DB. Ci sono dei casi in cui occorre provare così perchè magari il file in admin non funzia bene


  • User Newbie

    Eccomi di nuovo...non ho avuto internet per un po di tempo..
    Cmq Grazie Tomcat...sn riuscito a trovare ed abilitare...sapevo ke i dati li salvava da qlc parte...ma nn sapevo dove!!
    Ora devo solo impratikirmi per modificare i templates e gli stili!!!
    Grazie ancora!!


  • User Newbie

    salve a tutti, volevo ringraziarvi....in particolar modo dario00 e Tomcat (che mi ha seguito su un altro post). grazie a quanto scritto nella "guida" di dario, sono riuscito ad inserire la colonna di destra. in pratica ho letto la guida è mi è venuta l'intuizione...il file che dovevo controlloare era sts_template.htm. in pratica mancava tutta la colonna (tag <td>contenuto</td>) di destra. l'ho aggiunta, inserendo un box esistente (information.php) e viene visualizzata, ma non correttamente.

    in pratica la larghezza della colonna di destra è molto + piccola di quella di sinistra....troppo. secondo voi come potrei fare per sistemarla????