• Moderatore

    [Joomla! 3] PecTable lista transazioni per PayPal Express Checkout

    Questo thread è dedicato a PecTable, un modulo per Joomla! 3 che mostra la lista delle transazioni effettuate con PayPal Express Checkout.

    Cosa sono PayPal Express Checkout e PecTable
    PayPal Express Checkout è un'estensione a pagamento che permette di vendere prodotti digitali in maniera semplice, incassando con PayPal.
    PecTable integra questa estensione. Si tratta infatti di un modulo da front end che mostra una tabella con le informazioni sulle transazioni effettuate, ovvero sui prodotti digitali venduti.

    A cosa serve PecTable
    Quando si usa PayPal Express Checkout per vendere prodotti digitali di utenti diversi può essere utile mostrare agli autori quanti "prodotti" sono stati venduti, in modo da indicare anche quanto è stato incassato. Con PecTable gli autori hanno una "contabilità semplificata" delle vendite dei loro prodotti.

    Da dove nasce l'idea di PecTable
    Nobody.1990, un utente del Forum GT, ha aperto una discussione incentrata su come mostrare una sorta di "contabilità semplificata delle vendite" ai diversi autori, senza che questi accedano al back end. La discussione è qui: http://www.giorgiotave.it/forum/joomla/234130-acceso-utenti-back-end-sito-web.html
    Dal confronto è emersa come possibile soluzione la creazione di un modulo aggiuntivo, così è nato PecTable.

    Discalimer su PayPal Express Checkout
    Non abbiamo "scelto" questa estensione, semplicemente l'esigenza di Nobody ne prevede l'uso: se si fosse trattato di un'altra estensione avremmo cercato comunque una soluzione.

    Versioni e download di PecTable
    L'ultima versione disponibile al 1.7.2015 è la v.0.4.0 che è scaricabile a questo indirizzo:
    download.francescodagostino. it/files/joomla/pectable/mod_pectable_v040.zip
    Il link sopra è inattivo, per farlo funzionare fai "copia e incolla" nel browser eliminando lo spazio vuoto prima di "it". Seguendo il link scaricherai il file zip pronto per l'installazione.

    Installazione di PecTable
    Accertati di avere installato già PayPal Express Checkout sul tuo sito in Joomla! 3.
    Scarica PecTable e installalo come una qualunque altra estensione. Accedi al back end, menu superiore > *extensions *> extension manager > upload package file > clic su scegli il file > seleziona il file dal computer (dove l'hai archiviato dopo averlo scaricato) > clic su upload & install.

    Creazione di un modulo PecTable
    Dal back end, menu superiore > *extensions *> module manager > clic sul pulsante *New *> tra i tipi di modulo scegli PecTable con un clic.
    Inserisci il title, che potrai eventualmente nascondere impostando show title su hide.
    Scegli la posizione per il modulo (position), lo stato (*published *per mostrarlo), il livello di accesso (access) e le altre opzioni a partire da quelle del tab module.

    Opzioni del modulo
    Nella schermata principale (tab module) sono presenti le seguenti opzioni:

    • Rows shown: numero di righe che vuoi mostrare, utile per limitare il numero di prodotti da mostrare nella pagina, ad esempio agli ultimi 10 (10 è anche il valore di default).

    • Table type: si riferisce al modo in cui viene costruita in html la tabella con le righe; al momento sono disponibili 2 opzioni che prevedono entrambe i div, con Bootstrap e senza (Div with Bootstrap è la soluzinoe più pratica).

    • Table header: per mostrare o nascondere la riga delle intestazioni.

    • Table header class: permette di specificare una classe per la riga delle intestazioni.

    • Data columns: permette di selezionare le colonne da includere, ovvero le informazioni da mostrare per ciascuna transazione. Al momento le informazioni disponibili sono:

    • item id: codice del prodotto

    • product: nome del prodotto

    • purchase id: codice della transazione

    • purchase date: data della transazione

    • total amount: prezzo corrisposto dall'acquirente per la transazione

    • fee amount: importo trattenuto da PayPal sulla transazione

    Le opzioni presenti nei restanti tab (menu assignment, module permissions, advanced) funzionano come in tutti gli altri moduli di Joomla.

    Accesso riservato a un gruppo
    Se vuoi mostrare questa tabella soltanto agli autori devi procedere così:

    • installa l'estensione;
    • crea un nuovo gruppo per gli autori oppure associa gli autori ad un gruppo specifico già esistente;
    • per il modulo PecTable imposta *access *sul gruppo scelto.

    Il gruppo che hai scelto deve avere accesso dal front end (preferibile e in ogni caso PecTable è un modulo per front end) e fare il login per vedere PecTable.

    Lingue
    Al momento nel modulo sono previste le lingue:

    • Italiano
    • Inglese (da revisionare)

    Puoi aiutarci a tradurre il modulo in altre lingue e/o controllare che le traduzioni presenti siano corrette. 🙂

    Come appare PecTable nel front end e nel back end
    Il titolo lo scegli tu e puoi eventualmente nasconderlo.
    Lo stile può essere modificato agendo con le opzioni e le classi via css.
    La larghezza delle colonne dipende da quante colonne ci sono (nell'immagine sotto sono 6) e da quanto è largo il div che contiene il modulo.
    L'opzione Div senza Bootstrap permette di superare il concetto di tabella con righe e colonne (puoi creare ad esmepio delle schede o dei "post it" agendo sui fogli di stile).

    image

    Sopra: il modulo nel front end. Sotto: il tab *module *di PecTable nel back end.

    image

    Licenza e cosa puoi fare con PecTable
    L'estensione è distribuita con licenza "GPL 2 e successive versioni" e quindi puoi fare tutto e solo ciò che permette questo tipo di licenza, tra cui ovviamente usarla e distribuirla. Non è obbligatorio ma gradito un link a questa discussione, in modo che gli utenti sappiano che esiste un luogo in cui confrontarsi per migliorare il modulo e parlare di Joomla.
    In soldoni, l'estensione è gratuita e quindi non puoi venderla, ma puoi farti pagare ad esempio per installarla. Puoi anche modificarne il codice a patto di distribuire l'estensione modificata con la stessa licenza e di attribuire il lavoro originario al suo autore e le modifiche a te.

    Come contribuire a PecTable
    Puoi contribuire a PecTable:

    • partecipando a questa discussione con idee e suggerimenti per migliorare il modulo
    • partecipando allo sviluppo del modulo
    • suggerendo modifiche per migliorarne la sicurezza (se sei esperto in PHP fatti avanti)
    • testando il modulo
    • fornendo una tua traduzione del modulo o correggendo una traduzione esistente

    Tutte le novità, versioni e features
    Ad ogni nuova release verrà pubblicato un post in questo thread con il link per scaricare il zip.
    Le informazioni riportate sopra potrebbero essere in parte superate dalle features presenti nell'ultima release disponibile, perciò leggi sempre gli ultimi post della discussione e se hai dubbi non esitare a scrivere un post, la discussione è aperta. 😉


  • User Newbie

    Un possibile miglioramento, già discusso nel post "originale", può essere la realizzazione di un modulo complementare tale da consentire ad ogni utente di visualizzare esclusivamente le proprie vendite.
    Eventualmente potrebbe poi essere visualizzato il profitto netto di ogni utente a fine mese.

    P.S. La versione 0.4.0 funziona perfettamente :ciauz:


  • Moderatore

    Ciao Gino, grazie. Buona idea il profitto mensile per utente. Al secondo modulo ci sto già lavorando. 😉


  • User

    Il profitto netto quindi si azzererebbe alla fine di ogni mese?
    In tal caso forse sarebbe meglio riportare il profitto del mese corrente e di quello precedente in modo che l'utente possa visualizzare con calma quanto gli spetta senza dover guardare l'ultimo giorno del mese :smile5:


  • Moderatore

    Che ne dite di questo trio di proposte?

    1. Per il singolo autore:
    • grafico/tabella con il profitto mensile e il numero di download degli ultimi 12 mesi
    • grafico/tabella con il profitto mensile e il numero di download diviso per prodotto
    1. Modulo a parte, da mettere pubblico o privato a scelta, con la classifica dei prodotti digitali più venduti (numero di download e profitto) nell'ultimo mese e nell'ultimo semestre.

    2. Plugin che mostra nella pagina del singolo articolo delle informazioni "in automatico" sotto certe condizioni, ad esempio:

    • se il prodotto digitale è stato scaricato almeno 5 volte mette "il badge con 1 stellina", se i download sono almeno 25 mette "il badge con 2 stelline", se sono almeno 100 mette "il badge con 3 stelline";
      oppure:
    • se il prodotto digitale è stato scaricato almeno 10 volte nell'ultimo anno e se fa parte dei primi 10 prodotti scaricati allora inserisce nel post un badge.

  • User

    Perfette tutte e tre le proposte !! :vai:


  • User Newbie

    Novità sul modulo?
    Il plugin che inserisce stelline in base al numero di download è un'idea molto bella.
    Se c'è bisogno d'aiuto, pur lavorando, cerco di trovare del tempo.


  • Moderatore

    Ciao Gino_giorgetti,
    ho battuto la fiacca ultimamente :D, adesso si riprende.
    Portiamo a termine il modulo per gli utenti, così possiamo fare query anche sui dati utente.

    Se c'è bisogno d'aiuto, pur lavorando, cerco di trovare del tempo.

    Grazie!! 🙂 Se riesci a trovare un po' di tempo puoi occuparti di qualunque cosa (un modulo/plugin aggiuntivo, traduzioni, test, altre idee tue) e condividere in questo topic idee, proposte, codice, errori...
    Se migliori l'estensione posta qui la soluzione, così aggiorniamo i file. :wink3:


  • User

    Le mie capacità sono molto limitate al computer (direi nulle :giggle:) comunque per test e traduzioni posso dare una mano se avete bisogno

    😄


  • Moderatore

    @Nobody.1990: le traduzioni sarebbero molto apprezzate!
    Andrebbe controllato l'inglese e se conosci altre lingue...

    I file delle traduzioni sono nella cartella language dell'estensione. Per ogni lingua trovi due file. Come esempio posto i due file in italiano.

    it-IT.mod_pectable.sys

    
    MOD_PECTABLE="PecTable"
    MOD_PECTABLE_XML_DESC="PecTable mostra la tabella con le transazioni di prodotti digitali eseguite con l'estensione PayPal Express Checkout."
    MOD_PECTABLE_LAYOUT_DEFAULT="Default"
    
    

    it-IT.mod_pectable

    
    MOD_PECTABLE="PecTable"
    MOD_PECTABLE_XML_DESC="PecTable mostra la tabella con le transazioni di prodotti digitali eseguite con l'estensione PayPal Express Checkout."
    MOD_PECTABLE_COUNT_LABEL="Righe mostrate"
    MOD_PECTABLE_COUNT_DESC="Il numero di righe mostrate in tabella."
    MOD_PECTABLE_TABLETYPE_LABEL="Tipo di tabella"
    MOD_PECTABLE_TABLETYPE_DESC="Seleziona il tipo di tabella."
    MOD_PECTABLE_VALUE_DIV_BOOTSTRAP="Div con Bootstrap"
    MOD_PECTABLE_VALUE_DIV_NO_BOOTSTRAP="Div senza Bootstrap"
    MOD_PECTABLE_TABLEHEADER_LABEL="Table header"
    MOD_PECTABLE_TABLEHEADER_DESC="Scegli se visualizzare i nomi delle colonne."
    MOD_PECTABLE_TABLEHEADER_CLASS_LABEL="Table header class"
    MOD_PECTABLE_TABLEHEADER_CLASS_DESC="Inserisci il nome della classe associata al div che contiene le intestazioni delle colonne."
    MOD_PECTABLE_TABLECOLUMN_LABEL="Dati da visualizzare."
    MOD_PECTABLE_TABLECOLUMN_DESC="Scegli quali colonne vuoi mostrare in tabella."
    
    

    Le traduzioni si modificano cambiando i valori tra virgolette doppie, per capirci quelli che in ciascuna riga si trovano alla destra del segno di uguale. Non bisogna mai cambiare un solo carattere di ciò che si trova alla sinistra del segno di uguale (il malfunzionamento dell'estensione potrebbe fare esplodere il tuo computer e provocare un maremoto in Papuasia :eheh:).

    Vuoi aggiungere una nuova lingua? Nulla di più semplice: duplica i due file precedenti e cambia il nome... ok, scrivo una mini guida in un nuovo topic. :wink3:


  • User

    Va bene.
    Oggi pomeriggio controllo l'inglese 😉


  • User

    @FDA
    Ti ho inviato per mail il file lingua inglese controllato


  • Moderatore

    Grazie Nobody,
    aggiungiamo alla prossima release. :figo2:


  • User

    :ciauz:


  • User

    :ciauz: FDA.

    Qualche novità in vista?


  • Moderatore

    Ciao Nobody, sono mancato per un po'... adesso riprendo tutti i 7569 bandoli delle rispettive matasse, ovviamente ingarbugliatissme, tra cui anche quella del modulo. :bigsmile:
    Dammi qualche giorno.


  • User

    Ciao FDA.
    Scusami se ti rispondo solo ora ma sono all'estero ed al momento sono molto occupato.
    Ovviamente non c'è alcuna fretta, ti sono grato per l'aiuto.

    A risentirci
    :ciauz:


  • Moderatore

    Buon viaggio e buon lavoro. :ciauz: