Opencommercio - E-commerce in Italia

a. modifiche ai testi e alla larghezza del sito

La larghezza del sito è impostata con un valore relativo, cioè in percentuale: ciò significa che il layout del negozio si ridimensiona secondo la risoluzione del monitor di chi visita il nostro negozio: cioè non ci saranno mai le due fasce verticali di riempimento a sinistra e a destra del negozio. Ma il vantaggio della dimensione relativa che si adegua alla risoluzione del monitor del visitatore può portare anche a distorsioni nella costruzione delle tabelle che definiscono la pagina: es. se mettiamo un logo di colore azzurro in alto, grande 458 pixel e lo sfondo dell'header giallo, il visitatore con una risoluzione dello schermo 800x600 magari vede l'immagine ben allineata sul bordo sinistro della pagina, un visitatore con risoluzione dello schermo 1024 vedrà il logo compreso in uno spazio giallo di circa 100 pixel a sinistra e 100 a destra.... Molti grafici preferiscono perciò, maggiormente se il layout è costruito usando immagini per bordi o intestazioni, o anche solo da immagini composte nell'header, usare dimensioni fisse. Vediamo come si cambia il sito dal layout relativo a quello fisso:

Aprire il file catalog/index.php, trovate la larghezza della tabella principale impostata al 100% in queste righe:

< table border="0" width="100%" cellspacing="3" cellpadding="3">
< tr>
< td width="<?php echo BOX_WIDTH; ?>" valign="top"><table border="0" width="<?php echo BOX_WIDTH; ?>" cellspacing="0" cellpadding="2">
< !-- left_navigation //-->

Bisogna modificare quel width="100%" in width="770", cioè dimensione fissa larghezza di 770 pixel. La stessa modifica deve essere poi fatta in tutti i files della cartella principale (/catalog) e in /includes/header.php e footer.php. Lo so, è un lavoraccio, ma OSC/OPC ha la grafica preimpostata nel codice....

Le modifiche ai testi:

Per modificare i testi delle intestazioni dei blocchi, dei contenuti dei blocchi e dei messaggi di errore, bisogna aprire il file /catalog/includes/languages/italian.php che contiene le definizioni dei testi generali del negozio. Invece, tutti i testi delle varie pagine, compresa la index.php, si trovano nella cartella /catalog/includes/language/italian/ e hanno lo stesso nome della pagina alla quale si riferiscono. I testi che si trovano tutti concentrati come definizione di costanti nei files di lingua, hanno sempre la seguente forma:

define('COSTANTE', 'Traduzione per quella costante');

Certi caratteri (come backslah \, l'apice', ecc...) non possono esere usati perchè hanno un altro significato in PHP, percui devono essere preceduti dal backslash, è il caso dell'apice: es. define('BOX_HEADING_WHATS_NEW', 'Novita\''); Potete usare liberamente il linguaggio HTML e farle lunghe quanto volete.

- Il titolo della pagina nella barra el titolo del browser si modifica in /catalog/includes/languages/italian.php, trovate:

define('TITLE', 'OpenCommercio.com: Supporto italiano E-commerce');

- Il footer, cioè il messaggio di copyright in fondo alla pagina, sempre in /catalog/includes/languages/italian.php

Il messaggio di copyright non è obbligatorio, ma almeno come ringraziamento allo staff di opencommercio/oscommerce si raccomanda di tenere almeno un link a tali siti.

- il test principale della home page lo trovate in /catalog/includes/language/italian/index.php:

define('TEXT_MAIN', 'Questa e\' la configurazione base di OpenCommercio, i prodotti sono mostrati solo per scopi dimostrativi, qualsiasi prodotti ordinato non sara\' consegnato e nemmeno fatturato. Tutte le informazioni sui prodotti in vetrina sono puramente finte. <table border="0" width="100%" cellspacing="5" cellpadding="2"><tr><td class="main" valign="top">' . tep_image(DIR_WS_IMAGES . 'default/1.gif') . '</td><td class="main" valign="top">Messaggi d\'errore Se dovessero comparire degli errori o warnings in alto, correggeteli prima di procedere. I messaggi d\'errore sono visualizzati in alto nella pagina con un colore di sfondo particolare. Sono previsti svariati controlli che permettono una buona configurazione del negozio - questi controlli possono essere disabilitati modificando gli appositi parametri in fondo al file includes/application_top.php.</td></tr><td class="main" valign="top">' . tep_image(DIR_WS_IMAGES . 'default/2.gif') . '</td><td class="main" valign="top">Modificare questo testo Il testo che state leggendo puo\' essere modificatonelle varie lingue, nel seguente file: [percorso catalogo]/includes/languages/' . $language . '/' . FILENAME_DEFAULT . ' Il file puo\' essere modificato manualmente oppure attraverso il Pannello di Amministrazione selezionando Lingue ->' . ucfirst($language) . '->Definisci oppure Strumenti->File Manager moduli. Il testo e\' impostanto nel seguente modo: define(\'TEXT_MAIN\', \'Questa e\' la configurazione base di Opencommercio...\'); Il testo evidenziato in verde puo\' essere modificato - nel define() della variabile TEXT_MAIN. Per rimuovere completamente il testo di TEXT_MAIN, lasciare solo i doppi slash con apice in questo modo:& lt;br> define(\'TEXT_MAIN\', \'\'); Ulteriori informazioni sull\' uso della funzione PHP define() function sono reperibili <a href="http://www.php.net/define" target="_blank">quì</a>.</td></tr><tr><td class="main" valign="top">' . tep_image(DIR_WS_IMAGES . 'default/3.gif') . '</td><td class="main" valign="top">Proteggere il Pannello di Amministrazione E\' fondamentale proteggere il Pannello di Amministrazione dato che al momento non ci sono implementazioni incluse nel sistema.</td></tr><tr><td class="main" valign="top">' . tep_image(DIR_WS_IMAGES . 'default/4.gif') . '</td><td class="main" valign="top">Documentazione online Potete trovare documentazione sull\'installazione e la configurazione nel file installa.html incluso nel pacchetto e online sul sito <a href="http://www.opencommercio.com" target="_blank">OpenCommercio.com</a>. Trovate supporto sui <a href="http://www.opencommercio.com" target="_blank">Forum di OpenCommercio.com</a>.</td></tr></table> Per scaricare il pacchetto completo o contribuire al supporto, visitate <a href="http://www.opencommercio.com" target="_blank">il sito di supporto di OpenCommercio.com</a>. Questo negozio utilizza la versione ' . PROJECT_VERSION . '.');

Vedete? ci potete mettere un pò tutto quello che volete in una funzione define(): in TEXT_MAIN troviamo HTML, variabili e costanti PHP, link, immagini, ecc. Usatela un pò come Home Page del vostro negozio.

- Condizioni di utilizzo del negozio: le trovate nel file /catalog/includes/languages/conditions.php e potete modificare come vi pare.

- Tutela della privacy: trovate il testo nel file /catalog/includes/languages/privacy.php

- Aggiungere testo all'e-mail di conferma ordine: aprite il file catalog/checkout_process.php e trovate il seguente codice quasi in fondo al codice:

// lets start with the email confirmation
$email_order = STORE_NAME . "\n" .
EMAIL_SEPARATOR . "\n" .
EMAIL_TEXT_ORDER_NUMBER . ' ' . $insert_id . "\n" .
EMAIL_TEXT_INVOICE_URL . ' ' . tep_href_link(FILENAME_ACCOUNT_HISTORY_INFO, 'order_id=' . $insert_id, 'SSL', false) . "\n" .
EMAIL_TEXT_DATE_ORDERED . ' ' . strftime(DATE_FORMAT_LONG) . "\n\n";

modificate come segue:

// lets start with the email confirmation
$email_order = STORE_NAME . "\n" .
// testo aggiuntivo che appare nella mail
$email_order .= "\nL\'azienda vi ringrazia per l\'ordine.! \nArrivederci ! \n" .
// fine testo aggiuntivo

EMAIL_SEPARATOR . "\n" .
EMAIL_TEXT_ORDER_NUMBER . ' ' . $insert_id . "\n" .
EMAIL_TEXT_INVOI CE_URL . ' ' . tep_href_link(FILENAME_ACCOUNT_HISTORY_INFO, 'order_id=' . $insert_id, 'SSL', false) . "\n" .
EMAIL_TEXT_DATE_ORDERED . ' ' . strftime(DATE_FORMAT_LONG) . "\n\n";

Notate il punto finale di ogni istruzione: in PHP è l'operatore di concatenazione, cioè è una specie di +. Notare nel testo anche il carattere \n: è il punto a capo del PHP. Notare anche il carattere d escape \' usato per l'apice...

- Testo dell'e-mail di registrazione al cliente: lo trovate in /catalog/includes/languages/create_account.php: tutte le costanti che iniziano per _EMAIL.