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

Cod. Ultima revisione Wiki Note
829 2024/04/05- MM custom_layout


Struttura Pacchetto

Per la  predisposizione del pacchetto sono necessarie competenze di programmazione nei linguaggi  html , js, php

E' necessario richiedere tramite assistenza l'accesso al sistema di gestione pacchetto ordine richiedendo l'abilitazione di specifici setting
Il pacchetto è una cartella contenente una serie di file da utilizzare per la gestione della visualizzazione documento e varie funzionalità legate all'ordine.

Nell'immagine la struttura base della cartella.



I file base sono is seguenti

  • index.html
  • script.js
  • style.css
  • jquery.js
  • index_local.html
  • server_order.php
  • print.php
  • it.json
  • de.json
  • en.json
  • es.json
  • fr.json
  • content.json
  • mail.html
  • README.TXT


IN FASE DI REDAZIONE ... 


1) index.html: pagina che verrà sempre letta e mostrata

2) server_order.php: è necessario per la visualizzazione in server. Non deve mai cambiare.

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 in locale deve essere creato un file identico, in questo esempio index_local.html con un'unica riga in più nelle intestazioni
<script type="text/javascript" charset="utf-8">setupWithLanguage('it');</script>
con 'it' che può essere sostituito a seconda della lingua che si vuole utilizzare.

A) Javascript: generalmente viene usato il framework jquery, jquery.js, e il file standard script.js.
B) Css: In generale viene usato il file sytle.css
D) Json: vengono utilizzati i file di lingua con le traduzioni che funzionano in abbinata al file script.js
C) 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 dall'ambiente






Inoltre 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 amministrativa dei pacchetti , agli sviluppatori, è messa a disposizione un ambiente per caricare il pacchetto personalizzato sottoforma di  zip della cartella
che si è personalizzata .

E' resa disponibile

a) un area Sandbox ove caricare il pacchetto in sviluppo e su cui  effettuare le prove e i test  tramite appositi menu che verranno descritti più avanati 

Gestisci pacchetto ordine per sviluppo


a) un area Ufficiale ove caricare il pacchetto definitivo che verra reso disponibile agli utenti


Gestisci pacchetto ordine




.... 
Le regole di caricamento permettono di caricare solo 2 file php, uno necessario al funzionamento (vedi punto 2 "Struttura Pacchetto") e uno facoltativo, print.php.

Inoltre deve essere evitato qualsiasi tipo di codice improprio nel file print.php.

https://test-enterprise.zotsell.com/admin/document...

Nel caso il pacchetto non funzionasse a dovere è sempre possibile cancellare il pacchetto o disabilitare il pacchetto da settings.
... 


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.
Si accede all'area tramite apposito menu come da questa immagine

E' possibile inoltre configurare degli utenti nella gestione dei setting sviluppatori perché il pacchetto possa essere testato su applicazione.

https://test-enterprise.zotsell.com/admin/document...

Verifiche Sandbox

Nell'interfaccia di gestione ordini in admin

https://test-enterprise.zotsell.com/admin/manageor...

per gli sviluppatori, sono presenti dei link aggiuntivi in arancione per testare il funzionamento del pacchetto in sandbox.
Una volta testati il pacchetto potrà essere caricato nell'interfaccia definitiva.


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