bbPress

Info

• 12 posts
• 6 voices
• Started 2 years ago by johnhiler
• Latest reply from johnhiler

Tags

• codex
• documentation

• Posts in this topic

Jumpstarting the bbPress Codex

1. • 
   • johnhiler
   • Member

   • Posted 2 years ago #

   Sam mentioned that he might set up a codex for us to start documenting bbPress... so I thought it might be useful to round up useful links with info we could cleanup for a bbPress codex:

   Versions:
   http://bbpress.org/forums/topic/new-stable-version-version-0905
   http://bbpress.org/forums/topic/bbpress-10-release-candidate-1
   http://bbpress.org/forums/tags/releases

   WordPress and bbPress signin integration:
   http://bbpress.org/forums/topic/wordpress-and-bbpress-integration-101
   http://bbpress.org/forums/topic/basic-integration-screencast

   Theme integration:
   http://bbpress.org/forums/topic/seemless-wordpress-integration

   php compatibility issues:
   http://bbpress.org/forums/topic/warning-cannot-yet-handle-mbcs-in-html_entity_decode
   http://bbpress.org/forums/topic/warning-cannot-yet-handle-mbcs-in-html_entity_decode-in-home2

   Writing plugins:
   http://bbpress.org/forums/topic/overwriting-template-functions
   http://bbpress.org/forums/topic/list-of-hooksactions

   Importing data:
   http://bbpress.org/forums/topic/importing-from-phpbb

   Translation:
   http://bbpress.org/forums/topic/how-to-translate-bbpress-to-another-language
   http://bbshowcase.org/forums/topic/bbpress-translation-internationalization-into-local-languages

   Roles:
   http://bbpress.org/forums/topic/adding-a-new-user-type?replies=6#post-9210

   Miscellaneous FAQ's:
   http://bbpress.org/forums/topic/forums-started-39-years-ago

   Please chime in and share what you'd like to see documented in a bbPress codex... and also, any links you've found particular valuable!
2. • 
   • Sam Bauers
   • Key Master

   • Posted 2 years ago #

   The Codex is coming...

   Will be after 1.0 release though. Probably sometime next wek.
3. • 
   • swaymedia
   • Member

   • Posted 2 years ago #

   Well im ready to help you guys out. Im intensly theme developing.
4. • 
   • johnhiler
   • Member

   • Posted 2 years ago #

   Cookies

   We should probably have a general writeup of how Cookies work in both WordPress and bbPress, across versions... how the WordPress cookie was changed in versions 2.5 and 2.6, and how the bbPress cookie was changed from 0.9 to 1.0 (and any other changes that you can think of!)

   Of particular note would be which versions integrate well with each other (e.g. how bbPress 0.9 doesn't have native support to integrate with the latest WordPress versions... so for a number of months, the only way to upgrade WordPress was to upgrade to the alpha 1.0).

   Also, ck's bbPress cookie upgrade plugin... and Superann's WordPress cookie downgrade plugin (to allow 0.9 to talk to the latest WordPress cookies).

   Anyone enough of a Cookie guru to draft a general writeup of how cookies work, and the general cookie compatibility issues we've seen? I think we can do better than the WordPress Codex, which seems really vague:
   http://codex.wordpress.org/WordPress_Cookies

   Integration

   Might be worth sharing links to people who have integrated bbPress with non *Press user logins:
   http://bbpress.org/forums/topic/bbpress-integration-2

   Maybe also a writeup on "deep" *Press integration versus other more "shallow" forms of integration (shared login)... some useful links on that:
   http://bbpress.org/forums/topic/first-pass-at-a-fix-for-deep-integration-in-trunk

   Any other links on deep versus shallow integration?
5. • 
   • massbase
   • Member

   • Posted 2 years ago #

   im having to guess each and every class and function, just by how i might think they're named.... I really can't wait for the codex.
6. • 
   • OmiKami08
   • Member

   • Posted 2 years ago #

   Is there one that shows a list of compatible/working plugins for the different versions? WordPress has something like that:
   http://codex.wordpress.org/Themes/Theme_Compatibility/2.7
   http://codex.wordpress.org/Plugins/Plugin_Compatibility/2.7

   I'm asking because if it's not there it might be a good addition.
7. • 
   • johnhiler
   • Member

   • Posted 2 years ago #

   Ah sure, we could add that! Anyone interested in maintaining the Plugin Compatability part of the Codex?
8. • 
   • Ipstenu
   • Member

   • Posted 2 years ago #

   I started this:

   Rc1 compatible plugins
   http://bbpress.org/forums/topic/list-of-plugins-that-work-on-rc1
9. • 
   • massbase
   • Member

   • Posted 2 years ago #

   I hope this codex isnt going to be just a really long forum post.

   I hope the codex lists all bbpress functions, like wordpresses so's we can build our own themes and stuff.
10. • 
    • johnhiler
    • Member

    • Posted 2 years ago #

    Yah, the codex will be a wiki with lots of information. We'll list all the functions and try to make it easier for plugin/theme developers to learn the ropes!
11. • 
    • Ipstenu
    • Member

    • Posted 2 years ago #

    Think of this as a reference post we'll go back to, in order to get information to make a tubularly cool super sexy bbPress Codex magnifique!

    Sorry, it's been a day.
12. • 
    • johnhiler
    • Member

    • Posted 2 years ago #

    SPAM
    It'd probably be useful to have a section on registration and post spam, along with the various techniques to fight it:
    http://bbpress.org/forums/topic/request-to-the-experienced-what-anti-spam-tools

    PERMALINKS
    Some general stuff on htaccess and pretty permalinks (and how support for different approaches to permalinks vary across hosts):
    http://bbpress.org/forums/topic/dropping-multiviews-support
    http://bbpress.org/forums/topic/pretty-permalinks-not-working
    http://bbpress.org/forums/topic/pretty-permalink-type-change-gives-me-a-404-error

    VERSION DIFFERENCES
    It'd also be helpful to have a summary table showing major differences between the different versions, especially for people using plugins and unsure if an upgrade will break their plugins.

    For example, version 1.0 uses BackPress plus it uses WordPress' latest taxonomy stuff. Plus it has a new approach to meta data. So if an 0.9 compatible plugin depends on any of this stuff, it will probably break in 1.0 unless the plugin's been specifically updated for the latest version.

    TAGS

    Tag permissions - who can add and remove tags:
    http://bbpress.org/forums/topic/members-can-add-tags

    How hot tags work and can be formatted:
    http://bbpress.org/forums/topic/hot-tags

    Reordering of hot tags:
    http://bbpress.org/forums/topic/alphabetical-ordering-of-hot-tags

    Multi-byte characters (this may have been addressed in recent versions):
    http://bbpress.org/forums/topic/unable-to-add-mutibyte-character-tags

13. You must log in to post.