==Introduzione==
Usate la guida semplificata che riassume tutti i passaggi che dovete fare, la trovate qui:
http://www.almack.ch/joomla-cb-phpbb-integrazione/introduzione-integrazione.html
La guida sul wiki serve solo a far vedere ogni singolo passaggio per l'integrazione.
Con questa guida si vuole spiegare in modo semplice come integrare gli utenti con Joomla, forum phpBB e la gallery Coppermine.
La guida è suddivisa in punti.
Questa guida può soddisfare i seguenti bisogni:
Integrare il forum phpBB con Joomla
Integrare il forum phpBB con Joomla e Coppermine con phpBB
Il vantaggio di questo processo è quello di non dover modificare a mano il database ma viene fatto tutto automaticamente in modo grafico rendendo il tutto dinamico.
In questa guida troverete del software, testatelo prima di metterlo su un sito di produzione!
Per i temerari ho inglobato tutte le modifiche extra nella sezione [[Joomla_phpBB_coppermine#Hack]], non sono difficili ma con queste alla fine avrete una integrazione perfetta tra Joomla+CB+phpBB+Coppermine.
==Joomla==
Joomla è un potente CMS gratuito e scaricabile da qui [http://www.joomla.org www.joomla.org] o dai vari siti con le varie lingue preferite, ad es. in italiano [http://www.joomla.it www.joomla.it]
Per poter integrare gli utenti di phpBB in Joomla è disponibile un componente che permette oltre alla condivisione di utenti anche di creare delle comunità virtuali. Questo componente di chiama Community Builder. Con un apposito plugin (rilasciato come non stabile) si può integrare e condividere i vari utenti.
===Installazione di Joomla===
L'installazione è semplicissima basta scaricare il pacchetto che si vuole dal sito di joomla. Spacchettare il file .zip in una cartella temporanea sul computer. Collegarsi al proprio sito via ftp o altri metodi e copiare tutto il contenuto della cartella temporanea appena creata sul web.
A questo punto basta accedere da un normale browser al proprio sito e concludere l'installazione.
Per coloro che hanno già un sito funzionante esistono dei plugin per fare il backup del sito vedere anche su [http://www.joomla.org www.joomla.org]
===Configurazione di CB (Community Builder)===
Adesso che Joomla è installato scarichiamo il pacchetto da qui
[http://www.almack.ch/files/Joomla/CBuilder1_0_2_unzip1st.zip Community Builder 1.0.2] o direttamente dal sito originale [http://www.joomlapolis.com/ www.joomlapolis.com] (occorre registrarsi). Salvarlo sul computer e come prima operazione spacchettarlo. Troverete altri 4 files .zip. A questo punto basta entrare con un brower sul vostro sito ed accedere all'interfaccia di amministrazione.
1)Cliccare su installa nuovo componenete ed installare il file comprofiler.zip.
2)Installare mod_comprofileronline.zip come modulo (permette di visualizzare gli utenti online)
3)Installare mod_comprofilermoderator.zip come modulo
4)Installare cblogin.zip come modulo (serve per sostituire il normale login di joomla)
5)Disabilitare il modulo di login standard di Joomla ed abilitare quello appena installato (cblogin).
6)Sincronizzate gli utenti Joomla con CB entrando nel menu di CB e cliccatre su Tools e poi Synchronize Users
A questo punto si è installato CB in Joomla, ci resta soltanto di mettere ancora il plugin che permetta di condividere gli utenti con Joomla e phpBB.
===Installare il plugin===
Se avete eseguito tutte le istruzioni riportate sopra e tutto funziona correttamente potete continuare con questa procedura.
Attenzione fare un backup del database e delle cartelle del vostro sito, quello che seguirà è un'operazione che potrebbe causare perdita di dati o utenti, non mi assumo nessuna responsabilità in caso di problemi. Potete comunque scrivere sul [http://www.almack.ch/it/forum.html forum].
Scaricare il plugin da [http://www.almack.ch/files/Joomla/plug_phpbbconnector_v1.0.2+patch.zip plug_phpbbconnector_v1.0.2.zip](Attenzione é senza patch dunque funziona solo con le versioni vecchie di Joomla) o dal sito originale [http://www.joomlapolis.com www.joomlapolis.com], ho aggiunto la versione patchata che risolve alcuni problemi, la potete trovare qui [http://www.almack.ch/files/Joomla/plug_phpbbconnector_v1.0.2+patch-v2.zip plug_phpbbconnector_v1.0.2+patch-v2.zip].
Nuova versione modificata personalmente. Ho risolto un bug: quando si carica una nuova immagine in CB viene inserita l'immagine ridimensionata nel forum e non l'immagine originale.
[http://www.almack.ch/files/Joomla/plug_phpbbconnector_v1.0.2+patch-v2.zip plug_phpbbconnector_v1.0.2+patch-v2 for CB.zip]
Ho aggiornato i files con una nuova patch che toglie dei warning durante la visualizzazione del plugin, potete trovare [http://www.joomlapolis.com/component/option,com_joomlaboard/Itemid,38/func,view/id,20590/catid,34/ qui] la descrizione del problema.
Questo plugin è marcato come non stabile e potrebbe creare problemi, nel mio caso è sempre funzionato tutto alla perfezione. Se avete installato una versione di Joomla maggiore della 1.0.8 é consigliabile installare il plugin con la patch.
Elenco delle modifiche nella nuova patch beta:
{| width=100% border="2" cellspacing="0" cellpadding=18 style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; padding:10px;"
|
===README.txt for Patch Files===
1) phpbbconnector.php
This file patches a found bug which causes users to not be activated in phpBB when in CB "Require Admin Approval" is set to No. Fix for already exported users is to check the phpbb_users table and make sure user_active is 1. (except for Anonymous, User_id=-1... keep his user_active to 0)
Updated 4-19-2006... also has "remember me" login fix
2) LIMIT phpbbgui.php
This file patches the control panel. Some users with large user databases had trouble importing or exporting the users. This file limits it to 2000 users at a time and generally makes it work.
Rename the file to phpbbgui.php and replace the current file.
Side issue that was seen includes users with special characters in their names causing problems during import. A patch is not complete for this yet. Part of the issue is that Joomla does not allow special characters and it looks like phpBB does... not to mention the obvious lack of escaping database values upon import... This will be fixed in 1.0.3
3) phpbbgui.php
This file includes the LIMIT phpbbgui patch above as well as include modifications so that the newer (Joomla 1.0.8 or so) admin login is used. This should prevent the bug where the ADMIN login was shown when clicking on the Control Panel. You should only see the admin login when the admin session is expired. Please report if this is not the case. This also includes the fix for RG_EMULATION=OFF
|}
Qui trovate il sito ufficiale: [http://developer.joomla.org/sf/frs/do/viewRelease/projects.phpbb_connector/frs.phpbb_connector_patches.version_1_0_2 Patch phpBBconnector]
Una volta scaricato entrare con il vostro browser nel pannello di Joomla.
Entrate nel componente Community Builder e apparirà nella lista un'opzione per l'installazione di plugin (Plugin manager). Cliccate ed andate in fondo alla pagina dove trovate il posto per poter fare l'installazione.
Dopo aver installato il plugin (sempre nella stessa pagina dei plugin di CB) cliccate su di esso e vi apparià una finestra, immettete il nome della cartella dove è contenuto il forum (es: phpBB o forum, ecc...). Salvate e per motivi sconosciuti chiudete la finestra e poi subito dopo ricliccate sul plugin per riaprirla. A questo punto può cominciare la condivisione vera e propria, cliccate su "Plugin control panel" e apparirà una finestra di popup. In quest'ultima potete importare e sincronizzare gli utenti tra phpBB e Joomla.
Finita la sincronizzazione potete accedere da Joomla ed automaticamente sarete loggati anche sul forum. Se non fosse il caso è possibile che la prima volta ci si deve loggarsi anche su forum con l'opzione memorizza password selezionata.
==Hack==
===Intro===
In questa sezione é possibile fare in modo di escludere completamente la registrazione ed il login di phpBB e Joomla ed utilizzare invece esclusivamente il componente Community Builder per l'amministrazione gli utenti.
===Hack phpBB===
Per usare lo stesso login di CB con phpBB, togliere le scritte login ecc.. trovate la guida qui: [[hack_phpBB]]
===Hack Joomla&CB===
Per fare il redirect delle richieste di registrazione e login di Joomla e passarle al componente CB.. trovate la guida qui: [[hack_Joomla&CB]]
==Coppermine==
Questa parte è semplicissima, infatti in coppermine sotto "Strumenti Admin" c'è la possibilità di condividere gli utenti con un forum phpBB od altri.
1)Entrare in coppermine come amministratore e cliccare su "Strumenti Admin"
2)scorrere la lista fino in fondo e cliccare su "Bridge Manager"
3)scegliere dalla lista il forum phpBB versione maggiore di 2.0.18
4)Concludere
==Conclusioni==
Seguendo questi semplici passi è stato possibile installare Joomla, phpBB e Coppermine condividendo gli utenti tra i tre. Il sistema non è ancora stabilissimo e potrebbero accadere fatti strani, questo per causa del plugin di CB che non è stabile. Per mia esperienza fino adesso ha sempre funzionato tutto alla perfezione senza nessun problema.
Se avete domande o miglioramenti scrivete pure sul [http://www.almack.ch/it/forum.html forum].