ZotSell
Wizard Home | Admin Server | Documenti Vendita | Ordini: visualizzazione lista documenti vendita | Sotto funzioni | HTML | Dettaglio Ordine Personalizzato Advanced

Cod. Ultima revisione Wiki Note
933 2024/04/12 - MM

Struttura e gestione pacchetto

Per una personalizzazione più avanzata della stampa degli ordini, offriamo un pacchetto dedicato appositamente a questo scopo. Questo pacchetto include tutti i file necessari per configurare la stampa degli ordini, come ad esempio l'index.html, lo style.css e altri file rilevanti per la stampa in formato HTML.

Caratteristica

Nota: per predisporre correttamente il pacchetto, sono richieste competenze di programmazione nei linguaggi HTML, JavaScript e PHP

Per ottenere l'accesso al sistema di gestione del pacchetto ordini e abilitare le impostazioni specifiche, è necessario richiederlo tramite il servizio di assistenza.

Il pacchetto consiste in una cartella contenente una serie di file destinati alla gestione della visualizzazione dei documenti e delle varie funzionalità legate agli ordini.

Nell'immagine seguente è riportata la struttura base della cartella:


File base

  • index.html (pagina che viene sempre letta e mostrata)
  • script.js
  • style.css
  • jquery.js
  • index_local.html
  • server_order.php (necessario per la visualizzazione in server. Non deve mai cambiare)
  • print.php
  • it.json
  • de.json
  • en.json
  • es.json
  • fr.json
  • content.json
  • mail.html
  • README.TXT

IN FASE DI REDAZIONE ... 

Struttura generale.
Visualizzazioni e file relativi

  1. HTML: viene letto il file index.html, al cui interno può essere impostato javascript/css/json e eventuali risorse quali immagini.
    Per lo sviluppo locale deve essere creato un file identico, in questo esempio "index_local.html".
    Questo file contine in più, rispetto al file index.html la seguente riga di codice: <script type="text/javascript" charset="utf-8">setupWithLanguage('it');</script>
    Con setupWithLanguage('it'), si può impostare la lingua, per farlo basta inserire al posto di 'it' la lingua che si vuole utilizzare
    Standard presenti nella cartella:
    1. Javascript: generalmente viene usato il framework jquery, jquery.js, e il file standard script.js.
    2. Css: In generale viene usato il file sytle.css
    3. Json: vengono utilizzati i file di lingua con le traduzioni che funzionano in abbinata al file script.js
    4. Risorse: varie ed eventuali, quali immagini o file di contenuto.

  2. Pdf: viene letto il file print.php. La stampa pdf funziona solo a livello di server. Se non presente viene usata quella standard.
  3. Mail: viene letto il file mail.html. Se non esiste il file html viene inviata la mail standard. Il file mail.html supporta la sostituzione dei tags.


Operazioni preliminari

Per poter operare inizialmente è necessario scaricare il pacchetto base presente nell'apposito ambiente.
Andare nella rotellina in alto a sinistra e selezionare la voce "Document order configurations"
Verrà visualizzata la seguente pagina:

UI document order configurations

Abilitare il pacchetto e/o elimitarlo a determinati utenti

Per abilitare il pacchetto o abilitarlo solo per determinate utenze (indicando l'email) devono essere modificati i settings presenti in admin per gli sviluppatori
Area Settings

Menu per setting Ordini

Settings disponibili

Gestione Pacchetto

Nell'area amministrattiva dei pacchetti ci sono due ambienti messi a disposizione per gli sviluppatori in cui è caricare il pacchetto personalizzato:
  1. Ambiente di test/sendbox: ambiente in cui è possibile effettuare delle prove e dei test
  2. Ambiente ufficiale di produzione: ambiente in cui caricare il pacchetto ufficiale, dopo effettuate apposite prove e test.
Nota: la cartella che si carica deve essere nel formato .zip

Regole di caricamento e best practice

  • Si possono caricare solo 2 file file php, uno neccessario al funzionamento e uno facoltativo denominato print.php
  • Non importare codice improprio o non pertinente nel file print.php

Gestione Sandbox

La gestione sendbox permette di caricare un pacchetto per testare se quest'ultimo funziona, senza cambiare il pacchetto definitivo o la configurazione esistente.
E' possibile inoltre configurare degli utenti nella gestione dei setting sviluppatori perché il pacchetto possa essere testato su applicazione.

Verifiche Sandbox

Nell'interfaccia di gestione ordini in adminper gli sviluppatori, sono presenti dei link aggiuntivi in arancione per testare il funzionamento del pacchetto in sandbox.
Eseguiti i test, il pacchetto potrà essere caricato nell'interfaccia definitiva.

Nota: nel caso il pacchetto non funzionasse a dovere, è possibile cancellare il pacchetto o disabilitarlo dai settings


Settings disponibili

Setting Descrizione Codice riferimento
Abilita Utente sviluppatore Serve indicare una email amministratore presente nel server a cui abilitare tale menu enable_developer_users_list
Attenzione La modifica dei setting di default è un operazione che comporta delle attività di riconfigurazione e ri-compilazione e personalizzazione e come tale comporterà un costo.
Una volta abilitati tali setting l'utente configurato avra accesso al menu digestione come da immagine

Argomenti Correlati

  • Dettaglio Ordine Personalizzato Advanced -