Installazione vbBridge per integrazione di Wordpress con vBulletin

In questa guida verrà* illustrato come integrare Wordpress con vBulletin attraverso l'installazione e la configurazione del vbBridge e la modifica di Wordpress stesso.

Pre-Requisiti e materiale necessario:

• vBulletin 3.8.4
• Php 5
• Apache 2
• vbBridge

Installazione di Wordpress

• aprire una shell di comando ed entrare in MySql (mysql -u nome_utente -p) [Figura 1];
• creare un database per WordPress (create database nome_database;

Figura 1

• andare nella directory di WordPress che avete posizionato precedentemente nella DocumentRoot del web server e aprire il file wp-config-sample.php ed editarlo nel seguente modo:[Figura 2]

Codice:

define(''DB_NAME'', ''nome_database'');
define(''DB_USER'', ''nome_utente'');
define(''DB_PASSWORD'', ''password'');
define(''DB_HOST'', ''localhost''); //nel caso in cui il db non sia sulla stessa macchina di wordpress inserire l''ip della macchina;
$table_prefix = ''wp_''; //prefisso (se lo volete) che avranno le tabelle del db di wordpress (utile se il servizio di hosting mette a disposizione un solo db);

Figura 2

• salvare il file e rinominarlo wp-config.php;
• puntare il browser verso WordPress (per esempio localhost/wordpress oppure ip_macchina/wordpress);
• inserire titolo del blog e la mail dell''administrator e fare installa;
• l'installazione è completata a questo punto copiare la password generata automaticamente e fare il login dopodiche è consigliato andare a modificare la password dell''administrator nell''apposito pannello utente.

IMPORTANTE: al fine che l''integrazione con vBulletin abbia successo WordPress e vBulletin devono risiedere nello stesso dominio.
IMPORTANTE: nel caso in cui non abbiate a disposizione la shell dei comandi basta utilizzare phpMyAdmin e un qualsiasi client FTP che ci permetta di raggiungere il nostro scopo
IMPORTANTE: nel caso il vostro servizio di hosting vi metta a disposizione un solo database non è un problema in quanto è sufficiente mettere prefissi diversi per le tabelle di WordPress e vBulletin in modo da poterle identificare facilmente

Installazione vBulletin

• aprire una shell di comando ed entrare in MySql (mysql -u nome_utente -p) [Figura 1];
• creare un database per vBulletin (create database nome_database [Figura 1];
• andare nella directory di vBulletin che avete precedentemente posizionato nella DocumentRoot del web server e aprire il file config.php.new posizionato nella directory includes/ ed editarlo come segue:[Figura 3]

Codice:

$config[''Database''][''dbname''] = ''nome_database'';
$config[''Database''][''tableprefix''] = ''vb_''; //prefisso (se lo volete) che avranno le tabelle del db di vbulletin (utile se il servizio di hosting mette a disposizione un solo db);
$config[''Database''][''technicalemail''] = ''tua_e_mail'';
$config[''MasterServer''][''servername''] = ''localhost''; //nel caso in cui il db non sia sulla stessa macchina di vbulletin inserire l''ip della macchina;
$config[''MasterServer''][''username''] = ''nome_utente'';
$config[''MasterServer''][''password''] = ''password'';

Figura 3

• salvare il file e rinominarlo config.php;
• puntare il browser verso vbulletin piu precisamente sul file per l''installazione /install/install.php (per esempio localhost/vbulletin/install/install.php oppure ip_macchina/vbulletin/install/install.php);
• leggere i vari step proposti e cliccare su next (sono 13 passaggi);
• nel caso ci siano dei problemi (per esempio di permessi sulle cartelle andare a risolvere il problema e ripetere gli step);
• allo step 9 inserire le informazioni richieste (tipo nome forum, nome homepage, posizione ecc..)
• allo step 11 inserire i dati per l''account di administrator;
• arrivati allo step 13 l''installazione è completata manca solo di eliminare il file install.php nella directory install/ e cliccare sul link di termine installazione

IMPORTANTE: al fine che l''integrazione con vBulletin abbia successo WordPress e vBulletin devono risiedere nello stesso dominio.
IMPORTANTE: nel caso in cui non abbiate a disposizione la shell dei comandi basta utilizzare phpMyAdmin e un qualsiasi client FTP che ci permetta di raggiungere il nostro scopo
IMPORTANTE: nel caso il vostro servizio di hosting vi metta a disposizione un solo database non è un problema in quanto è sufficiente mettere prefissi diversi per le tabelle di WordPress e vBulletin in modo da poterle identificare facilmente

Installazione del vbBridge

IMPORTANTE: il bridge funziona solo se sia vBulletin che WordPress appartengono allo stesso dominio;

• mettere i file del vbBridge nella directory di wordpress dedicata ai plugins (wp-content/plugins)
• fare attenzione che i files vbbridge.php e functions_wysiwyg2.php siano nella directory plugin di WordPress e non in una sotto-directory;
• accedere a wordpress nel pannello di amministrazione ed attivare il vbBridge (plugins-->installati-->vbbridge)[Figura 4]

Figura 4

• andare in impostazioni-->vbBridge Settings e modificare come segue: [Figura 5]

Codice:

cVB User ID: userid con cui verra iniziato un thread se l''autore non è registrato in vBulletin (guest)
VB Username: username con cui verra iniziato un thread se l'autore non è registrato in vBulletin (guest)
VB Forum ID: id del forum di default dove tutti i threads saranno postati se non altrimenti "direzionati". questa opzione indica anche quale forum sara direttamente selezionato nel menu dropdown che verra creato nella pagina di insermineto di un articolo.
Forum URL: indirizzo del forum (esempio http://www.tuo_sito.com/forum senza index.php, eventuali slashes o altro)
Forum Relative Path: path relativo al forum (se per esempio il forum è in http://www.tuo_sito.com/forum il path relativo sara /forum)
Database Prefix: prefisso che avete dato alle tabelle di vBulletin (se lo avete fatto altrimenti lasciare l''opzione in bianco)
Turn Plugin On: selezionare yes. questa opzione attiva il plugin
Post Articles To Forum: selezionare yes. questa opzione aprira un nuovo thread nel forum quando un articolo viene inserito in wordpress

IMPORTANTE: per ora lasciate tutte le altre opzioni inalterate le andremo a modificare una volta che siamo sicuri che il pugiln funziona
cliccare su submit per salvare le impostazioni


Figura 5

• se avete problemi con path andate nel file vbridge.php e modificate la seguente riga (anche se è probabile che avete sbagliato qualche path dei punti sopra):

Codice:

## If you are having path problems, uncomment this next variable and define the path
## NO TRAILING SLASH!
$vwd = ''http://www.tuo_sito.com/path_del_forum'';

• aggiungendo il path del vostro forum
• andare in impostazioni-->lettura per modificare l'opzione "Codifica delle pagine e dei feed" con lo stesso tipo di codifica che usa il forum vBulletin. Di default è ISO-8859-1 (europa occidentale) se l'avete cambiata inserire la codifica scelta.(se la codifica tra vb e wp non è la stessa allora vb mostrera alcuni caratteri strani inoltre probabilmente sarà necessario cambiare la codifica del db wordpress settandola a latin1) [Figura 6]

Figura 6

• per modificare/controllare la codifica usata da vBulletin e controllare che sia uguale a quella di WoprPress: admincp-->languages & phrases-->language manager-->edit-->HTML Character Set [Figura 7]

Figura 7

• salvare le impostazioni di WordPress
• provare a scrivere un articolo di prova e che venga anche postato sul forum di vBulletin correttamente (ricordarsi di selezionare la categoria in cui si vuole aprire il thread in fondo alla pagina)
• se il post viene aperto anche in vBulletin allora fino qui avete fatto le cose giuste altrimenti ripetere i punti precedenti in cerca di errore
• ora andate in WordPress utenti-->vbBridge User Settings--> e mappate gli utenti vbulletin con gli utenti wordpress e la stessa cosa per i gruppi. se non si desidera mappare qualcosa lasciare "Do Not Map" selezionata per esempio potete mappare il gruppo di amministratori di vBulletin col gruppo di amministratori di WordPress.[Figura 8]

Figura 8

• una volta finito fare click su submit
• ok ora se tutto funziona andate in impostazioni-->vbBridge options e mettete "Turn Auto-Integrate On" su yes

ATTENZIONE: questa opzione non vi permettera più di loggarvi in wordpress quindi se non volete che cio accada lasciare l''opzione disabilitata

• se per qualche ragione dopo queste operazioni non riuscite a loggarvi piu in wordpress basta che cancelliante il file vbbridge.php e questo disattivera il plugin. poi puntate il browser su wordpress/wp-admin e sistemate tutto

Modifiche per redirigere i commenti nei threads di vBulletin

• trovare nei file wordpress/wp-content/themes/tuo_tema/index.php, wordpress/wp-content/themes/tuo_tema/single.php, wordpress/wp-content/themes/tuo_tema/page.php le seguenti righe di codice:

Codice:

if (have_posts())
while (have_posts()) : the_post()

oppure:

Codice:

if (have_posts()) : while (have_posts()) : the_post();

(che è la stessa di prima ma in un unico modulo php) e aggiungere il seguente codice subito sotto di esse:

Codice:

### Vbridge Call
$vbridge = Comment_Handler($pos-->ID);
###

• trovare sempre negli stessi file un codice del genere che indica la sezione commenti del vostro template

Codice:

wp_link_pages(); 
comments_popup_link(__(''No Comments'', ''kubrick''), __(''1 Comment'', ''kubrick''), __(''% Comments'', ''kubrick''), '''', __(''Comments Closed'', ''kubrick'') );

o simile e sostituirlo con il seguente:

• se volete linkare i vari autori wp agli autori vb ogni volta che incontrare il seguente codice

Codice:

the_author()

o simile potete rimpiazzarlo con:

• se volete eliminare la possibilita che gli utenti lascino commenti in wordpress (ossia togliere la textbox "Lascia un Commento") andare nella directory del vostro template ed elimare o commentare la seguentie linea:

Codice:

comment_template();

Integrazione template WordPress in vBulletin

• andate nella home page del vostro blog.
• click destro del muose sulla pagina e selezionate HTML o source (dipende dai browser) in altre parole visualizzate il codice html della vosta home
• cercare la parola "header" nel codice che dovrebbe essere in corrispondenza di un tag
• cercare la chiusura del tag corrispondente ad "header"
• copiare tutto il codice in mezzo tag compresi[Figura 9]

Figura 9

• andare nel pannello admin di vBulletin esattamente in : styles --> templates-->style manager-->all style options-->go-->header ed inserire all''inizio della textbox il codice che abbiamo copiato[Figura 10]

Figura 10

• sempre nel codice della home del vostro blog copiare tutto quello che ci sta prima dell'"header" appena copiato (ovviamente stiamo parlando sempre del codice)[riferimento Figura 9]
• andare nel pannello admin di vBulletin esattamente in : styles --> templates-->style manager-->all style options-->go-->headinclude ed inserire all''inizio della textbox il codice che abbiamo copiato [riferimento Figura 10 "headinclude"]
• dato che ci pensera vBulletin a formattare il codice nelle textbox si puo togliere alcuni pezzi che andrebbero a dupplicarsi dopo la codifica di vBulletin, quindi cancelliamo la parte relativa al
• ora allo stesso modo come sopra troviamo nel codice del blog la sezione "footer" [riferimento Figura 9]
• andare nel pannello admin di vBulletin esattamente in : styles --> templates-->style manager-->all style options-->go-->footer ed inserire alla fine della textbox il codice che abbiamo copiato [riferimento Figura 10 "footer"]
• salvate le impostazioni modificate.
• fondamentalmente la cosa è fatta dovete solo modificare solo le dimensioni del forum affinche "fittino" nel tamplate WordPress oppure viceversa.
• modificate il codice come volete affinche venga incontro alle vostre necessita

Soluzioni adottate

• eliminare nell''header il codice in
• inserire nell''header il logo ufficiale
• aggiungere sia all''header di WordPress che a quello di vBulletin un mini-menu per una navigazione migliore (con modifica del file header.php)