Thread: Developer docs?
View Single Post
  #7  
Old 07-07-2007, 01:53 PM
mfyvie mfyvie is offline
 
Join Date: Mar 2007
Location: Zurich, Switzerland
Posts: 336
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default

Quote:
Originally Posted by SimonVlc View Post
Well, a good starting point will be:
  • Detailed docs about how vb works from the first request.
  • Detailed docs about all the hooks available.
  • Detailed vb plugin development guides (why if not made the plugin system?).
All in a structured way.
I agree. I've been learning by reading through the code and trying to figure it out. I think the main point here is that the tutorials were developed by vbulletin customers, not by jelsoft. The sum total of what has been provided by Jelsoft is the API documentation and what is already in the vbulletin manual (in the developers section), which is great, but very limited.

The API documentation seems to have been auto-generated using the comments found within the existing code, and many of the functions themselves have not been documented, meaning that to figure out what they do involves jumping into the code (line numbers don't seem to correspond either) and trying to figure it out.

I think the product and plugin system for vbulletin is a great idea, and makes it really easy for the community to extend the functionality of vbulletin and easily share products and plugins with each other. However, it would be nice if Jelsoft could support this effort a little more by making life a little easier for those who are just starting out. Don't get me wrong, the tutorials are great (and I've written some of them), but I just feel like these tutorials have come as the result of a lot of head scratching and reverse engineering (at least that's how it was in my case).
Reply With Quote
 
X vBulletin 3.8.12 by vBS Debug Information
  • Page Generation 0.02756 seconds
  • Memory Usage 1,766KB
  • Queries Executed 11 (?)
More Information
Template Usage:
  • (1)SHOWTHREAD_SHOWPOST
  • (1)ad_footer_end
  • (1)ad_footer_start
  • (1)ad_header_end
  • (1)ad_header_logo
  • (1)ad_navbar_below
  • (1)bbcode_quote
  • (1)footer
  • (1)gobutton
  • (1)header
  • (1)headinclude
  • (6)option
  • (1)post_thanks_box
  • (1)post_thanks_button
  • (1)post_thanks_javascript
  • (1)post_thanks_navbar_search
  • (1)post_thanks_postbit_info
  • (1)postbit
  • (1)postbit_onlinestatus
  • (1)postbit_wrapper
  • (1)spacer_close
  • (1)spacer_open 

Phrase Groups Available:
  • global
  • postbit
  • reputationlevel
  • showthread
Included Files:
  • ./showpost.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_postinfo_query
  • fetch_postinfo
  • fetch_threadinfo_query
  • fetch_threadinfo
  • fetch_foruminfo
  • style_fetch
  • cache_templates
  • global_start
  • parse_templates
  • global_setup_complete
  • showpost_start
  • bbcode_fetch_tags
  • bbcode_create
  • postbit_factory
  • showpost_post
  • 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
  • showpost_complete