vBulletin LTS

PP-Popup - Photo-Popup for Photopost
Mod Version: 1.0, by cellarius

*** Preface and Credits ***

This is my fist released mod, so please be patient with me

When my long fostered Photopost-Popup, the well known and unrivaled Geek Gallery Popup, finally stopped working in IE I tried to find replacement. When I couldn't, I decided to tackle the job myself.

Credits go to the Geek not only for the idea, but also for parts of the code - or at least for a very great many of hints I took from looking at it. Since The Geek granted permission to use his abandoned code as base for new development, I felt free to do so. While some of the code is close to his, especially the trouble-rousing injection-process of the images into the editor follows different lines altogether.

Please note that this modification is Photopost only and there are no plans to change that - especially since I do not have other gallery software.

I use this on my own live board, but will not be liable for any problems it may cause. Use at your own risk.The mod is fully functional and has been tested on

• vB 3.7.4 (Sorry, not yet upgraded - perhaps someone else could test it?)
• PhotoPost 6.2
• with Browsers: Firefox, IE, Opera, Safari(Win) - all in their latest versions at time of release.

*** So, what does it do? ***

If you have installed Photopost, your users can click on a link below the smilies on the right in the editor. A window will pop up, where your users can click on their uploaded photos to insert them into the editor. Upon insertion the script will detect whether editor is in wysiwyg or codeview-mode and act accordingly, so that in wysiwyg-mode the actual image will be visible.

Several insert-options are available, and your users can choose from their own personal albums (or see all their uploaded photos).

*** What's in it? ***

Not much:
1 file-upload
1 product to import: bunch of phrases, a new Options-page in AdminCP and one template will be installed
1 template hack, done automatically if you're using TMS.

*** Installation ***

Is simple: Just upload pp-popup.php into your forum root, import the product file and
- if you're using TMS, you're done,
- if not, follow the instructions in templateedits.txt

*** Configuration ***

Just as easy: In the AdminCP go to vBuletin Options -> PP-Popup
There you'll find detailed instructions. See screenshot below.


*** Upgrade ***

Just reimport the product-xml-file, overwriting the old version, and reupload the pp-popup.php. Thats all.

*** Possible Pitfalls ***

Different databases setup

If your vB and PP use different databases, you'll have to activate the different databases setup in AdminCP/Options/PP-Popup. Furthermore, you'll have to give some information concerning the other database at the top of pp-popup.php file.

*** Debug Mode ***

There is a limited debug mode that shows some information only to administrators of the forum. Go to admincp, options and activate debug mode (set to yes).
Now you'll find the debug informtion on the bottom of the popup. If you do not get mysql-errors, the popup seems to work but you do not see any photos, please provide the information given in the debug box (especially datadir and code). If there are links given to original image and thumbnail, you can click them. if they don't work, there's probably a problem with your path to datadir.

*** Languages ***
German language file included. Import via phrases system.

*** Version history ***

-- v1.0
- complete rewrite of different databases setup, now tested and working
- added insert-options (7 different possibilities to insert images)
- of course, everythings phrased (or so I hope)

-- v0.3.1.
- added several new phrases
- changed templates accordingly. Please update template edits, TMS-users will receive those automatically
- added debug system, see this post.

-- v0.3
- new approach to implementing external PP-Database (if vB-db and PP-db are not the same). Should work, all db-Settings for PP are pulled from PP's config.inc.php, no more configuration needed than a simple yes/no-choice.

-- v0.2
- fixed some issues in pp-popup.php that caused broken links (some hard coded paths changed into variables)
- extended javascript for image-injection, now detects whether wysiwyg- or codeview-mode is active; therefore in wysiwyg-mode no longer code is visible upon injection, but the actual image

-- v0.1
initial release