Contact form 7

Scarica plugin*

* Compatibile con Wordpress 4.0 o superiore

Tempo di Lettura: 8 minuti

Difficoltà: Intermedia

In questa guida

Requisiti

  1. Wordpress 4.0 o superiori
  2. Un account valido sulla piattaforma 4Dem
  3. Accesso ftp alla cartella plugins di wordpress
  4. Avere almeno una lista contatti nel tuo account 4Dem

Note di installazione

- L'installazione standard è stata eseguita su Wordpress 4.x. Ti consigliamo, prima di installarlo, di effettuare un backup completo di Wordpress e del suo database.

Descrizione

Integrare il Modulo di contatto CF7 con il sistema di newsletter di 4Dem.it. Aggiungi automaticamente invii di moduli a liste predeterminate in 4Dem.it, utilizzando la sua ultima API.

Installazione

L'installazione del plugin può essere effettuata secondo le metodologie standard previste da Wordpress, quindi:

  1. Metodo automatico dal pannello Admin di Wordpress: accedi alla sezione Plugin di Wordpress e seleziona Aggiungi Nuovo. Scegliere "Carica". Seleziona e carica il file .zip del plugin, inserisci le credenziali di accesso Ftp e attendi il completamento dell'installazione.
  2. Metodo manuale via Ftp: collega il tuo client Ftp all'hosting su cui risiede l'installazione di Wordpress. Sfoglia le cartelle fino a trovarti in WP-CONTENT/PLUGINS/. Carica qui il contenuto del file .zip che avrai scaricato prima dal tuo pc e che contiene il plugin.

Dopo aver caricato il plugin utilizzando uno dei due metodi descritti, accedi alla sezione Plugins di Wordpress dove vedrai il nuovo plugin "4Dem". Clicca su Attiva per attivarlo.

Una volta attivato il plugin, nel menù di amministrazione di Wordpress comparirà una nuova voce "Contact" che ti premetterà di gestire e creare i tuoi form.

Creazione del form

Una volta completata l'istallazione sarà possibile creare i tuoi form.

Occorrerà prima di tutto accedere al proprio account 4Dem.it e creare una Api Key per la connessione.

Una volta creata l'Api Key torna nella configurazione del modulo e inseriscila nel campo 4Dem Api Key.

Creare una Api Key

Per creare l'api key vai in "strumenti" (icona cassetta degli attrezzi nella topbar della console 4Dem), seleziona Api Key quindi fai click su "AGGIUNGI".

Associare una lista e i campi personalizzati

Se hai inserito correttamente l'Api Key ora potrai selezionare dal campo "Destination List" la lista 4Dem in cui andare a iscrivere i contatti che compileranno il form oltre che i relativi campi personalizzati creati in piattaforma.

L'unico campo obbligatorio è l'indirizzo email
A partire dalla versione 1.1.0 il plugin è in grado di gestire anche i campi personalizzati di tipo globale.

I campi di tipo globale sono campi personalizzati comuni a tutte le liste 4Dem, ciò significa che se compilato il valore del campo verrà inserito in tutte le liste 4Dem dov'è presente l'iscritto. Nel caso sia già presente un valore per quel campo questo sarà sovrascritto con il nuovo in tutte le liste. Se hai dei dubbi sul significato di campi locali e globali ti invitiamo a consultare questa guida.

Ricordati che devi assegnare un tag ai campi da te utilizzati nel form, per esempio il campo "Subscribers email" deve essere associato al tag [your-email]. Troverai comunque un elenco dei tag generati da cf7 in base ai campi inseriti nel tuo form appena sotto la checkbox "Use Custom Fields".

Ti sei dimenticato di creare un campo?

Con CF7 potrai creare velocemente un nuovo campo alla voce "Add New Custom Fields". Inserisci il nome del campo e fai click su ADD.

Installazione per console dedicate

Se hai una console con dominio personalizzato e desideri utilizzare l'integrazione Contact Form 7 è necessario effettuare alcune modifiche al codice dell'integrazione affinché questa sia compatibile con la tua console dedicata.

Vediamo insieme quali linee di codice e valori dovrai modificare, ma prima di cominciare scarica il plugin da qui.

Estrai i file dello zip e apri il file  cf7-adv-dem-ext.

Attenzione

i nomi dei file e l'annidamento delle cartelle non deve essere alterato!

Inserire l'endpoint del tuo apichannel

Il primo valore da modificare è il dominio su cui risiede il tuo apichannel ovvero la libreria api della tua console dedicata.

Il dominio del tuo apichannel è reperibile accedendo al menu "Strumenti" nella topbar della tua console quindi cliccando su "Apichannel". Copia il dominio della pagina che ti si aprirà quindi spostati sul file cf7-adv-dem-ext.

Vai alla riga 18 del file:

define( 'ADV_DEM_CF7_API_ENDPOINT', 'https://api.4dem.it');
E sostituisci a https://api.4dem.it il dominio precedentemente copiato
define( 'ADV_DEM_CF7_API_ENDPOINT', 'https://api.mio_dominio.it');

Inserire il dominio su cui risiede la console

Il secondo valore da modificare è la url su cui risiede la tua console, ovvero il dominio della url che vedi quando operi normalmente in console.

Copia il dominio della tua console e torna su file cf7-adv-dem-ext spostandoti alla riga 19 del codice.

define( 'ADV_DEM_CF7_MAILCHEF', 'https://mailchef.4dem.it');
Sostituisci ora a http://mailchef.4dem.it il dominio della tua console precedentemente copiato.
define( 'ADV_DEM_CF7_MAILCHEF', 'https://mio_dominio.it');

Ora non ti resta che salvare, comprimere nuovamente in uno zip il plugin e procedere con l'installazione.
Prima di procedere alla compressione e l'installazione se sei interessato a rendere anche il plugin whitelabel dovrai applicare anche le modifiche indicate sotto.

Consiglio

Per qualsiasi dubbio rivolgiti al tuo reparto sviluppo, oppure apri un ticket di assistenza tramite la tua console.

Rendere il plugin whitelabel

Il plugin sebbene non possa essere reso totalmente whitelabel è possibile personalizzarlo almeno nei suoi punti fondamentali, in particolare puoi:

- Modificare Il nome del plugin;

- Modificare la descrizione;

- Modificare Il nome della tab "4Dem extension" durante la creazione del form;

- Modificare la nota di inserimento api key.

Esattamente come per l'installazione è necessario procedere, contestualmente alla modifica del dominio console e dell'endpoint delle api visti sopra, anche alla modifica dei valori "stampati" per le 4 sezioni indicate sopra.

Nella seguente tabella ti indichiamo file, riga del codice e testo modificabile:

Sezione: Path: Riga del codice: Testo modificabile:
Nome Plugin cf7-4dem-it-extension\cf7-adv-dem-ext.php 2 Contact Form 7 4Dem.it Extension
Descrizione cf7-4dem-it-extension\cf7-adv-dem-ext.php
6 Integrate Contact Form 7 with 4Dem.it email marketing platform.
Automatically add form submissions to predetermined lists
in 4Dem console, using its latest API.
Tab "4Dem extension" cf7-4dem-it-extension\lib\adv-dem-cf7-functions.php 36 4Dem.it Email Marketing
Nota inserimento Api Key cf7-4dem-it-extension\lib\adv-dem-cf7-view.php 48 Insert a correct APIKey to work with 4Dem!