Go Back   vb.org Archive > vBulletin Article Depository > Read An Article > vBulletin 3 Articles
Reload this Page [How-To] Product Managament (vBulletin 3.5 RC 1 and up)
FAQ Members List Calendar Search Today's Posts Mark Forums Read

Reply
Page 5 of 12 « First 34 5 67 Last »
 
Thread Tools
[How-To] Product Managament (vBulletin 3.5 RC 1 and up)
Andreas's Avatar
Andreas
Join Date: Jan 2004
Posts: 6,863

 

Germany
Show Printable Version Email this Page Subscription
Andreas Andreas is offline 07-25-2005, 10:00 PM
This How-To is mainly meant for Hack-Developers, if you are only planning to use Hacks just read the End-User section.

Developers
vBulletin 3.5.0 RC1 introduces a new concept for customizing/modifying vBulletin: Products.
With Products, you can manage Plugins, Phrases, Settings and Templates in just one XML File.
Furthermore it supports Install/Uninstall Codes (for running queries, etc.), it also covers updating existing Hacks as you can add Codes for different Versions.

To start, you first have to turn on debug mode:
Put
PHP Code:
$config['Misc']['debug'] = true; 
in config.php.

Then go to ACP / Plugin System / Manage Products.
Click Add/Import Product.
In the second Form (Add New Product) fill in the Details for your Hack:
  • Product ID should be a unique ID for you Hack; it must not start with vb and should be lowercase only, not contain spaces or other special characters.
    Attention: The Product ID must not be longer then 15 characters.
  • Title should be the Title for your Hack
  • Version should be the Version.
    The Format shoud be Mainversion Subversion Subrelease
    Example: Myhack 1.0.0 Beta 1
  • Description should be a short description for you Hack, eg. what it does.

Afterwards, create all the Plugins, Phrases, Templates and Settings your Hack requires and make sure you select the Product you just created.
Important: Templates must be placed in the MASTER Style, Phrases in the MASTER Language

When you are finished, go to ACP / Plugin System / Manage Products and select Edit from the Dropdown next to your Product.

In the Form (Add New Install/Uninstall Code) add all Code necessary to install/uninstall your Hack (eg, Queries, etc.).
If you are updating an existing Hack, add new Install/Uninstall Codes for the new Version that just make the changes necessary to upgrade the previous Version; Product Management will make sure that all necessary Codes will be run.

If your Hack includes Usergroup Permissions/Bitfields, add the following Code to Install and Uninstall to rebuild the Bitfield cache:

PHP Code:
if (is_newer_version('3.5.1', $vbulletin->options['templateversion']))
{
    // Rebuild Bitfields
    // Do this for vBulletin < 3.5.1 *ONLY*; later versions rebuild
    // automatically and calling the builder in install code causes
    // the bitfields NOT to be rebuild correctly
    require_once(DIR . '/includes/class_bitfield_builder.php');
    vB_Bitfield_Builder::save($db);
    build_forum_permissions();
} 
When everything is done, go to ACP / Plugin System / Manage Products again and export the Product as XML; this will then include all Plugins, Templates, Phrases, Settings and Install/Uninstall Codes required.

End-Users
Go to ACP / Plugin System / Manage Products.
Click Add/Import Product, select the product XML File for the Hack you want to install.
If you are upgrading an existing Hack, make sure that Allow Overwrite is set to Yes

This How-To is (C) 2005 by KirbyDE and you are not allowed to redistribute it in any way without my explicit consent.
Reply With Quote
  #42  
Old 08-01-2005, 12:52 PM
akanevsky akanevsky is offline
 
Join Date: Apr 2005
Posts: 3,972
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
Quote:
Reason = I don't like MS too much
Jeez...
Anyway, how about this: make two versions, a PDF and a CHM, to satisfy both those who like and those who dislike MS. Please thanks
Reply With Quote
  #43  
Old 08-01-2005, 04:15 PM
Revan's Avatar
Revan Revan is offline
 
Join Date: Jan 2004
Location: Norway
Posts: 1,671
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
Quote:
Originally Posted by KirbyDE
Reason = I don't like MS too much
That's really anal. That's like saying "I refuse to zip my hacks because I hate the WinZip program. I am blatantly ignoring the fact that WinRar/WinAce/[insert name of unpacking software for Mac/Linux/Unix] can unpack these files."
Making the How-to's HARDER to use is IMHO completely against the point of making them. I consider this a kick in the nuts to the community. This paragraph (and only this) will be retracted if someone can show me a way to copy/paste from Adobe Reader. I refuse to install any other piece of software to be able to copy/paste from a .pdf document, as I do not feel the need to clutter my computer with crap that will be used 1 or 2 times.
At any rate, see if you can stop me from making CHM files on my own computer (not to distribute).

Now to get back on the actual topic:
Ive learned the hard way that settings have to be volatile for them to be able to export properly, but won't this erase them on upgrade? The code in the xml_import_settings() makes me think that if you are trying to re-import settings that are marked as volatile, it will recreate these settings. This is not a desired effect, so I hope someone can prove me wrong
Reply With Quote
  #44  
Old 08-01-2005, 04:29 PM
Andreas's Avatar
Andreas Andreas is offline
 
Join Date: Jan 2004
Location: Germany
Posts: 6,863
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
Copying from PDF (if copying is permitted): Just use the Text Selection Tool, select the Text and click Edit/Copy.

Quote:
At any rate, see if you can stop me from making CHM files on my own computer (not to distribute).
Feel free to do that for your own. But as said, I do not allow distributing CHMs.

Volatile Settings will be deleted upon update. However, vBulletin only deletes its own (eg. produvt=vbulletin) Settings.
Reply With Quote
  #45  
Old 08-01-2005, 04:55 PM
akanevsky akanevsky is offline
 
Join Date: Apr 2005
Posts: 3,972
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
Quote:
That's really anal. That's like saying "I refuse to zip my hacks because I hate the WinZip program. I am blatantly ignoring the fact that WinRar/WinAce/[insert name of unpacking software for Mac/Linux/Unix] can unpack these files."
Making the How-to's HARDER to use is IMHO completely against the point of making them. I consider this a kick in the nuts to the community. This paragraph (and only this) will be retracted if someone can show me a way to copy/paste from Adobe Reader. I refuse to install any other piece of software to be able to copy/paste from a .pdf document, as I do not feel the need to clutter my computer with crap that will be used 1 or 2 times.
At any rate, see if you can stop me from making CHM files on my own computer (not to distribute).
I agree. "Reason = I dont like MS" is a very lame statememnt...

Quote:
Copying from PDF (if copying is permitted): Just use the Text Selection Tool, select the Text and click Edit/Copy.
That means I have to install Adobe PDF Editor, which is a bloated program that takes up a lot of space in my computer, and that is the reason why I do not have it installed. I'd rather just read the HowTo's from this site rather than from a PDF file...

Oh. And how can you restrict distrubting the CHM's? It's not like it is a copyrighted material. As long as your name is stated - there is no reason behind not distributing them, as well as there is no way you can "not allow it"...
Reply With Quote
  #46  
Old 08-01-2005, 05:00 PM
Andreas's Avatar
Andreas Andreas is offline
 
Join Date: Jan 2004
Location: Germany
Posts: 6,863
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
Quote:
Originally Posted by Dark Visor
That means I have to install Adobe PDF Editor, which is a bloated program that takes up a lot of space in my computer, and that is the reason why I do not have it installed.
No, just Arcobat Reader.

You don't like PDF, I don't like CHM and therefor I just don't support it.
So where is the Problem?

You can read the How-TOs here, build a CHM on your own or use the PDF (when there is one, which currently isn't the case anyway).

Quote:
And how can you restrict distrubting the CHM's? It's not like it is a copyrighted material. As long as your name is stated - there is no reason behind not distributing them...
It is copyrighted material. Everything one writes is automatically copyrighted if not stated otherwise.
(Although this might not always be the case considering general small talk and german copyright laws).

But if you feel happy, I can explicitly point this out too.
Reply With Quote
  #47  
Old 08-01-2005, 05:07 PM
akanevsky akanevsky is offline
 
Join Date: Apr 2005
Posts: 3,972
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
Quote:
No, just Arcobat Reader.
"just Acrobat Reader" is bloated enough itself... I prefer to use Easy PDF Reader, which consumes much less memory and therefore is easier to use. It, however, does not allow copying of the contents.

Quote:
You don't like PDF, I don't like CHM and therefor I just don't support it.
So where is the Problem?
The problem is that you are a minority on this case... The majority does prefer CHM. That's called being selfish. If you don't do it for other people, then why do it at all? I don't think anybody wants it in PDF format at all.

Quote:
It is copyrighted material. Everything one writes is automatically copyrighted if not stated otherwise.
(Although this might not always be the case considering general small talk and german copyright laws).

But if you feel happy, I can explicitly point this out too.
Ok. You are right - it is copyrighted. But as long as something is free and accessible by everyone, distribution in an easy-to-use-for-people format should be promoted. Because it will just make your name more known to other people. Besides, if I am stating your name in every article, I am not breaking the copyright. Prove me wrong.
Reply With Quote
  #48  
Old 08-01-2005, 05:12 PM
Andreas's Avatar
Andreas Andreas is offline
 
Join Date: Jan 2004
Location: Germany
Posts: 6,863
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
[ot]
Quote:
Originally Posted by Dark Visor
Besides, if I am stating your name in every article, I am not breaking the copyright. Prove me wrong.
Don't know for other contries, but german copyright laws do only permit personal usage and short ecerpts if you are publishing smth., you can't quote the whole document.

PDF is easy to use and available on multiple Platforms.

I am not going to support CHM.

EOD
[/ot]
Reply With Quote
  #49  
Old 08-03-2005, 03:51 PM
Dream's Avatar
Dream Dream is offline
 
Join Date: Oct 2001
Posts: 2,251
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
are product phrases considered orphan phrases?
Reply With Quote
  #50  
Old 08-03-2005, 04:05 PM
tehste tehste is offline
 
Join Date: Feb 2004
Posts: 221
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
I like the product/hook thing I found it intuitive enough. Though it was always nice to read what you had to say about it, oh and this thread has provided some good amusement...
Reply With Quote
  #51  
Old 08-28-2005, 07:14 PM
Princeton's Avatar
Princeton Princeton is offline
 
Join Date: Nov 2001
Location: Vineland, NJ
Posts: 6,693
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
Just starting to get into 3.5 - excellent tutorial :up:

thank you

EDIT: Is there any way to add a new hook without editing the xml file?
Reply With Quote
Reply
Page 5 of 12 « First 34 5 67 Last »

« Previous Thread | Next Thread »
Thread Tools

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts
BB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Forum Jump


All times are GMT. The time now is 04:39 AM.

Contact Us - Archive - Top

Powered by vBulletin® Version 3.8.12 by vBS
Copyright ©2000 - 2024, vBulletin Solutions Inc.
X vBulletin 3.8.12 by vBS Debug Information
  • Page Generation 0.08552 seconds
  • Memory Usage 2,332KB
  • Queries Executed 26 (?)
More Information
Template Usage:
  • (1)SHOWTHREAD
  • (1)ad_footer_end
  • (1)ad_footer_start
  • (1)ad_header_end
  • (1)ad_header_logo
  • (1)ad_navbar_below
  • (1)ad_showthread_beforeqr
  • (2)bbcode_php
  • (11)bbcode_quote
  • (1)footer
  • (1)forumjump
  • (1)forumrules
  • (1)gobutton
  • (1)header
  • (1)headinclude
  • (1)modsystem_article
  • (1)navbar
  • (4)navbar_link
  • (120)option
  • (1)pagenav
  • (1)pagenav_curpage
  • (4)pagenav_pagelink
  • (11)post_thanks_box
  • (11)post_thanks_button
  • (1)post_thanks_javascript
  • (1)post_thanks_navbar_search
  • (11)post_thanks_postbit_info
  • (10)postbit
  • (11)postbit_onlinestatus
  • (11)postbit_wrapper
  • (1)spacer_close
  • (1)spacer_open
  • (1)tagbit_wrapper 
Phrase Groups Available:
  • global
  • inlinemod
  • postbit
  • posting
  • reputationlevel
  • showthread
Included Files:
  • ./showthread.php
  • ./global.php
  • ./includes/init.php
  • ./includes/class_core.php
  • ./includes/config.php
  • ./includes/functions.php
  • ./includes/class_hook.php
  • ./includes/modsystem_functions.php
  • ./includes/functions_bigthree.php
  • ./includes/class_postbit.php
  • ./includes/class_bbcode.php
  • ./includes/functions_reputation.php
  • ./includes/functions_post_thanks.php 
Hooks Called:
  • init_startup
  • init_startup_session_setup_start
  • init_startup_session_setup_complete
  • cache_permissions
  • fetch_threadinfo_query
  • fetch_threadinfo
  • fetch_foruminfo
  • style_fetch
  • cache_templates
  • global_start
  • parse_templates
  • global_setup_complete
  • showthread_start
  • showthread_getinfo
  • forumjump
  • showthread_post_start
  • showthread_query_postids
  • showthread_query
  • bbcode_fetch_tags
  • bbcode_create
  • showthread_postbit_create
  • postbit_factory
  • postbit_display_start
  • post_thanks_function_post_thanks_off_start
  • post_thanks_function_post_thanks_off_end
  • post_thanks_function_fetch_thanks_start
  • post_thanks_function_fetch_thanks_end
  • post_thanks_function_thanked_already_start
  • post_thanks_function_thanked_already_end
  • fetch_musername
  • postbit_imicons
  • bbcode_parse_start
  • bbcode_parse_complete_precache
  • bbcode_parse_complete
  • postbit_display_complete
  • post_thanks_function_can_thank_this_post_start
  • pagenav_page
  • pagenav_complete
  • tag_fetchbit_complete
  • forumrules
  • navbits
  • navbits_complete
  • showthread_complete