vBulletin Project Tools - Project Tools Importer for forum threads

Beta warning

This is currently in beta stadium. I used it successfully on my forum, but there might be problems with other configurations. See below for current limitations and features not yet implemented.

Note for german speaking users: There will be a german version released and supported on vB GO once this mod reaches Release Candidate stage.


What's this mod for?

I needed a simple to use function to move my forum threads into the vBulletin Project Tools. This Add-on adds a new moderation link to the showthread page that allows you to import the thread into any project and issue type you are allowed to post in.

The source thread can either be left untouched or automatically be converted into a redirector that leads to the created issue. No data in the original thread will be lost, an easy restore function will be implemented in the future. Redirectors can show a prefix (like "Moved:" for thread redirectors) that can display the project title and the issue type.


What's new in Beta 3?

Code rewrite

This is a major rewrite of the whole codebase. The code has been optimized and redundant code has been moved to functions and classes. Please note that this means almost everything is new and this likely means there are new bugs in places that worked before. Use at your own risk!

Attachment import

The most requested functions has been added: You can now import attachments if vBulletin or Project Tools (or both, of course) store attachments in the file system. There's a new setting in the AdminCP where you can specify if attachments that do not meet the current limitations should be imported.

I was only able to test this on Windows based systems, but it should work on *NIX as well.

Other changes

A function has been implemented to allow the creation of a notice stating the issue has been imported (by which user at which date). It's enabled by default, but you can disable it in the AdminCP. See also the new screenshot attached.

There have been other minor changes, see the changelog below.


Functions implemented

• Import of threads (Issue)
• Import of posts (Notices)
• Import of attachments (Filesystem is now supported, too!)
• Import of subscriptions
• Create redirector (optional)
• Create a notice stating this note was imported (optional)

Current limitations

These limitations result on the fact that I created this Add-on mainly for myself and so I left out some features not important to me. They are planned to be fixed in Version 1.0.0.

• Currently you need the moderator permissions canmanagethreads and canremoveposts to import threads. Should be replaced by a new moderator permission (can convert all threads in a forum) and a new usergroup permission (can convert own threads).
• [s]Attachments will only be imported if both vBulletin and Project Tools are configured to save attachments in the database. Attachment limits will be ignored.[/s]

Functions planned

This functions will probably be added to a version after 1.0.0. Please post suggestions and comments so I can see where to go

• Allow to hide redirectors based on a global setting or on usergroup permissions
• Allow to completely delete the source during thread after import
• Allow to manually delete redirecting threads (imported x days before) using the AdminCP / ModCP
• Allow to automatically delete redirecting threads using vBCron
• Allow to associate status changes with posts during import (ex: change status to "Solved" at the same time a it has been posted)
• Mass import of multiple threads
• Export issues (back) into threads

Requirements

• vBulletin 3.6.7
• vBulletin Project Tools 1.0.0

Installation

These are some fast installation steps. There is a file ptimporter_install.txt in the zip file with more detailed instructions.

• Upload everything in the "upload" directory into your vbulletin home directory
• import the product file ./includes/xml/product-db_ptimporter.xml
  Note: select "Allow Overwrite" if upgrading
• Apply the two small template changes in ptimporter_templates.txt
  Note: Not needed if upgrading from Beta 2

Done.

[GameCrash]

Changelog

Version 1.0.0 Beta 3

New:

• Rewritten attachment import to allow import of attachments in the filesystem
• Added option to create a notice stating this note was imported

Improved:

• Rewritten almost everything to move redundant code to functions and classes
• Added template group (Thanks Yves)
• Some changes in the background to allow new functions in the future

Fixed:

• Fixed bug not allowing to choose issue type
• Reduced the amount of queries executed using caching

Version 1.0.0 Beta 2

• First public release

[radarhunter]

shucks missed it

[captainslater]

I'll check this later today but I think you saved my life with this

[PitchouneN64ngc]

This can help a lot of customers who want to convert some threads into issues for Project Tools

Thanks for this

[beduino]

Looks fantastic - will be a wonderful way to integrate vB and PT.
tks a lot
Beduino

[morrow]

What is 'project tools'?

[PitchouneN64ngc]

Originally Posted by morrow

What is 'project tools'?

http://www.vbulletin.com/features_project.php

For the beta test, I'm surprised this mod works very well

Just missing to add templates into cache ($globaltemplates) and add 14 queries for that :/

[captainslater]

Feature Request: By moving thread possibility to choose to create new issue (currently) or to create new task, or new feature.

[GameCrash]

Originally Posted by captainslater

Feature Request: By moving thread possibility to choose to create new issue (currently) or to create new task, or new feature.

Well, you should rename this to Bug Report... this would be possible if I hadn't forgotten a silly break; in the script I used for testing.

Just open ptimporter.php and remove the break; from Line 208.

Now you should be able to select the issue type if you have permission to create an issue in more than one...

Will also be fixed in the next beta, of course.