编辑“Integration:WBB3”

==Description==
Hi,<br />
my name is [http://codex.gallery2.org/User:Markusw Markus Wilhelm], here you can find information and explanations on embeding Gallery into Woltlab Buletin Board and Woltlab Community Framework. Informations about Gallery2 Embedding can be found here [[Gallery2:Embedding]] and all available integrations for Gallery1 here [[Integration]].

There is a problem with the rating module of Gallery in combination with WCF. I reported this issue to Gallery Bugtracker: http://sourceforge.net/tracker/index.php?func=detail&aid=1868824&group_id=7130&atid=107130

To solve this please use the following changes RatingHelper.class and store it to gallery2/modules/rating/classes/. You can find the changed classfile here: http://www.bessieundmarkus.de/component/option,com_docman/task,doc_download/gid,34/Itemid,60/

===Download===
You can download the Plugin on my website: http://www.bessieundmarkus.de/component/option,com_docman/task,cat_view/gid,26/Itemid,60/

Demo Embed: http://www.rettungshundeforum.de/portal/index.php?page=Gallery2<br />
Demo Gallery2: http://gallery.rettungshundeforum.de/<br />
PHPDoc: http://phpdoc.bessieundmarkus.de/de.bessieundmarkus.gallery2<br />
Readme: http://www.bessieundmarkus.de/component/option,com_docman/task,cat_view/gid,26/Itemid,60/<br />
Wiki: http://codex.gallery2.org/Integration:WBB3<br />
Bugs: http://bugs.rescue-dogs.de<br />
Subversion Repository:
# Ongoing Developments: svn://www.bessieundmarkus.de/wcf/trunk/de.bessieundmarkus.gallery2
# Released Versions: svn://www.bessieundmarkus.de/wcf/tags/
# Username: gast
# Passwort: gast
Subversion Repository Webbrowser: http://websvn.bessieundmarkus.de/


===Discussion===
You can discuss topics on Gallery2 Embeding into WBB3/WCF in 
* German http://www.woltlab.de/forum/index.php?page=Thread&threadID=115217
* English http://www.woltlab.de/forum/index.php?page=Thread&threadID=127529
'''Or in our Support Board specially created for G2 Integration: http://g2forum.bessieundmarkus.de/index.html'''


==Development History==

Detailed history can be found inside our Bugtracker.

'''de.bessieundmarkus.gallery - Version 1.0.8 PL6'''<br />
==============================================<br />
* 0000485: [Development] Wenn ich im Userprofil auf Galeri klicke stürzt das wbb3 ab (markuswilhelm)<br />


==Installation==
Just install it like any other kind of plugin. Remember to install Gallery2 first. To be able to change Gallery2 settings in ACP you will have to adopt changes to the WBB roles. Goto: User - Groups - Lust Groups and change any group you want to, preferable is the Administrator group. Then navigate to the administration rights tab and in the sub tab to content. Scroll down to the Gallery permissions and change like you want to have them.

After Installation you will have to change one template manually: '''userProfile.tpl'''

Search for:
 {if $user->getAvatar()}

And Include before:
<pre>
 {if $usergallerypages|isset}
	<div id="userProfileAvatar">
		<div class="border">
			<div class="containerHead">
				<div class="containerIcon"><img src="{@RELATIVE_WCF_DIR}icon/avatarM.png" alt="" /></div>
				<h3 class="containerContent"><a href="{$usergalleryurl}">Bilder von {@$user->username}</a></h3>
			</div>
			<div class="container-1">
				{@$usergallerypages}
			</div>
		</div>
	</div>
 {/if}
</pre>



==What can the Plugin do?==
The Pugin has three parts. Just display the Gallery2 Embed page, offering the user to change settings and offering the administrator several automized steps the configure and maintain the plugin data.
# Gallery Page
# User Profile
# Administration 


==Gallery Page==
Just display the Gallery2 Embed page. Several settings possible to maintain in Administration Control Panel (ACP).


==User Profile==
The part is about how the user can handle the gallery and its pictures. 


===Profile Page===
If for any reason the creation of an own album failed it is possible for the user to create his own album from his profile settings page.


===User Page===
Display og the users Album together with a random image realized with an image Block.


===Eventlistener: Password change===
Not jet realized. The idea is to offer (if whished) the possibility to use the Gallery Embed or as standalone witht the same users password, therefor the change of a password must be stored as well in the Galery2 database.


===Eventlistener: User Registration===
Not jet realized. The idea is to offer (if whished) the possibility to use the Gallery Embed or as standalone witht the same users password, therefor the initial password must be stored as well in the Galery2 database.


===Eventlistener: User Deletion===
Not jet realized. If a user is deleted in WBB than what has to happen to the user inside Gallery2 and its pictures?



==Administration ==
The part is about how the Admin can handle the gallery and what are the possible settings and problems. 


===Gallery Settings===
The initial settings for your galler can be set inside the ACP: System - Options - Gallery

* Set the paths to Gallery2
* Set the URL to your Gallery2
* Display Login Link
* Display Sidebar
* Syncronize Users and Groups by cronjob or manually.


===Link to Gallery===
You can find the settings after changing the respective roles inside the ACP, goto: Content Then you should see the Gallery as one entry in the menu bar. If not refresh you Window and/or check the groups settings for the Gallery.

The startpage of Gallery can be set to:
#Root Album
#UpdatesAlbum
#PopularAlbum
#RandomAlbum


===User Sync Page===
Sync the users and groups data and display all users available in wbb and Gallery


===Group Sync Page===
Sync the users and groups data and display all groups available in wbb and Gallery


===Eventlistener: Passwor change===
Not jet realized. The idea is to offer (if whished) the possibility to use the Gallery Embed or as standalone witht the same users password, therefor the change of a password must be stored as well in the Galery2 database.


==Embed and Rewrite URL==
See http://codex.gallery2.org/Gallery2:Modules:rewrite#URL_Rewrite_Embedded for general Dokumentation.

You have to proceed as follows:
# Logon to WBB and go to your Gallery e.g. http://www.rettungshundeforum.de/portal/index.php?page=Gallery2
# Go to the Gallery Administration page (Inside WBB, not inside Gallery standalone).
# Activate Short URL (Mod Rewrite) on the plugin page
# Go to configuration of Mod Rewrite
# Enter Path to WBB .htaccess, e.g. /your/path/to/wbb/installation/ (not the wcf path) when your WBB installation is stored in installation folder
# Enter URL to your WBB, e.g. /portal/ when your wbb is running in http://www.rettungshundeforum.de/portal/ like mine.
# Activate Plugin
# Finished
You can see an example on the demo page: http://www.rettungshundeforum.de/portal/updates or http://www.rettungshundeforum.de/portal/v/user/bessie/


==To Do==
*Several other things, see Bugtracker