Skip to content

BuddyPress Docs


Flattr this

BuddyPress Docs is a powerful and flexible tool for collaborative editing in BuddyPress.

BuddyPress Docs features:

  • Full integration with BuddyPress Groups Docs can be activated on a per-group basis, creating a Docs tab. Doc access, by default, is inherited from group privacy settings. Doc authors, as well as group admins and mods, can override these default settings so that visibility, editing, and commenting of a given doc can be more restrictive.
  • Full integration with activity streams Whenever you create, edit, or comment on a Doc, an activity item will appear in all relevant activity streams. These activity items obey group privacy settings, so that edits in private groups are private, etc. New dropdows in sitewide activity filters allow you to view Docs activity selectively. Full activity integration means that the plugin can be coupled with a plugin like BuddyPress Group Activity Subscription for fine-grained activity notification.
  • Front-end, rich editing BuddyPress Docs has full rich-text editing, powered by WordPress’s own TinyMCE editor. Because it’s the WordPress editor, users will experience the power and ease of use they’ve come to know from the Dashboard. Because it’s on the front end, users don’t ever need to leave your BuddyPress environment to edit Docs.
  • Doc tags With full taxonomy support, BuddyPress Docs lets your users tag and organize their content however they’d like. Doc lists can be filtered by tag for easy navigation. You can see at a glance how many times a tag has been used in a given group (and, in an upcoming release, sitewide).
  • Easy sorting and search When viewing Doc lists, you can sort by a number of criteria, making it easy to find what you’re looking for. There’s also a search box, which is smart enough to limit searches to specific group contexts dynamically.
  • Comments Leave comments on docs just like you would on blog posts.
  • Protections against overwrites To make sure that users don’t overwrite each other’s work, BuddyPress Docs only allows a single user to edit a Doc at a given time. To make sure that others aren’t blocked from editing by those who leave leave Docs open and then forget about them (ahem), there is a timeout and autosave after 30 minutes of idle time.
  • Developer goodies Built by the person who has (probably!) built more BuddyPress plugins than anyone else in the world, BuddyPress Docs is designed with extensibility in mind. do_action() and apply_filters() is everywhere. Add-ons like taxonomy and hierarchy, and integration pieces like groups (and the upcoming profile integration), are totally modular. BuddyPress Docs uses WP’s internal APIs wherever possible: custom post types, custom taxonomies, and more. Templates have been abstracted out to make theme overrides easy. And – inline documentation EVERYWHERE! Feedback from developers is welcome: ongoing development lives at http://github.com/boonebgorges/buddypress-docs.

Lots more development is coming! User profile integration, BuddyPress Documents upload integration, and more!

NOTE The plugin is listed as requiring WordPress 3.1 and BuddyPress 1.3. While I have been developing against the BP 1.3 trunk, it should work fine with BP 1.2.8 as well. However, do NOT use the plugin with WP 3.0.x, as it will expose private group Docs.

Instructions

  1. Upload the bp-group-reviews directory to your WP plugins folder and activate
  2. Activate Docs on a per-group basis in the group admin section

Download the plugin here.

BuddyPress Docs has been downloaded 19,666 times. Are you using this plugin? Consider a donation.

Version history

1.0-beta – March 1, 2011
Initial release

14 Responses to BuddyPress Docs

  1. Andreas says:

    Is this an early April Fool’s Joke? F***ING AWESOME.

  2. By the way if you’re frustrated with the default WordPress editor, there is a list of more than a dozen WordPress Editors at http://bloggerkhan.com/what-is-the-best-editor-for-wordpress/33 I have started experimenting with two. Let’s see.

    • Guy with a pizza in his mouth says:

      Thanks for the plugin!

      When will you add a hierarchy tree for multiple docs?

  3. Harry says:

    Hi Boone,

    thanks for the plugin. I am looking for a good Wiki plugin, will yours also work as a sitewide wiki, i.e. not just per group, but alos on a top level?

    Cheers

  4. Harry says:

    Installed and network activated it but doesn’t work.
    WP3.1.2 and BP 1.2.8, WPMU.

    I get the BP-docs menu and have created a category/Associated Item (country info) and an example page (Canada). Publish and save and view: http://biketravellers.com/?bp_doc=canada gives a 404 and no sign of any ‘docs’ in any menu.

    Tried deactivating WP-Groupblog, but no difference.
    1) Is this the slug it should have (http://biketravellers.com/?bp_doc=canada)?
    2) Where and how should the menu appear?
    3) is there a way to change the slug/name of the menu item?
    4) wil catergory pages (Associated Items?) automatically have an alphabetical list of Docs/wikis?

    Thanks in advance!
    Cheers, Harry

  5. Harry says:

    update: it seems to work for groups, once you figure out you have to go into the groups admin (front-end) and enable docs for that group, see http://biketravellers.com/groups/pan-am-riders/docs/country-info-2 for example.

    I would expect the slugs to be hierarchical, but they are all at the same level, so more like MediaWiki than regular pages.
    - The parent does show child pages, but not alphabetically and not in a list as you would both expect in a Wiki, can this be changed?
    - The list of all pages is also not alphabetically and the sorting does not work (see http://biketravellers.com/groups/pan-am-riders/docs/?orderby=title), so it will be hard to find a specific subpage.
    - No page created in the back end seems to work. Is there a way to have fairly toplevel docs, separate from groups? So domain.com/docs/category/title?

    Cheers

  6. Daisy Peel says:

    Editors cannot edit bp-docs in the back end / dashboard area, even though they have edit_posts and edit_others_posts capabilities. I need Editors to have this access, any idea for a workaround? I’ve already hacked some of the bp-docs code to allow the bp Docs menu accessible in the dashboard, even though originally it was only accessible to admins :)

  7. Hello Boone
    Do you have an ETA ;-) for site wide BP Docs (“v1.2″)?
    Would need it for that «Crisis Management» Site.

Pingbacks

  1. [...] Teleogistic God’s homepage Skip to content HomeDonateCodeWordPressShared BlogrollImport from Ning: Import Ning users to WordPress and BuddyPressAnthologizeSimple Import UsersPrezi WPBuddyPressBP Include Non-Member CommentsCustom Profile Filters for BuddypressBP TinyMCEInvite AnyoneBP MPO Activity FilterEnhanced BuddyPress WidgetsBP Import Blog ActivityBP Group ManagementForum Attachments for BuddyPressGroup Forum Subscription for BuddyPressBP System ReportBuddyPress Group Email SubscriptionBP External ActivityBP Lotsa FeedsBP Group ReviewsBuddyPress Docs [...]

  2. [...] BuddyPress Docs adds a new tab to groups where members can collectively create and edit documents, using an easy-to-use rich text editor. Docs support tagging, hierarchy, oEmbed multimedia, and much more. I’ve written about the feature list in detail on the BuddyPress Docs homepage. [...]

  3. BuddyPress Docs | Andrew Spittle on 03-Mar-11 at 12:38 am

    [...] plugin from Boone Gorges. It’s a front-end document editor for BuddyPress sites. Check out the feature list as [...]

  4. [...] ook kunnen samenwerken in 1 document zoals dat ook met Google Docs kan heeft Boone Gorges de BuddyPress Docs plugin geschreven. Het is momenteel nog in de testfase. Je kan helpen met testen van de plugin. Maar hij [...]

  5. [...] The biggest new feature of 1.2.0 is BuddyPress Docs. Developed by the Commons’ own Boone Gorges, BuddyPress Docs is a powerful new tool for the Commons and BuddyPress community that allows groups to collaboratively write and edit documents. BuddyPress Docs is a simple way for groups to work together on creating documents and store them on the Commons. The collaborative documents can be tagged, commented on, and and searched through by keywords. The Development team has also built in steps for overwrite protection to avoid losing data that you do not wish to have altered. Because only one person can edit a BuddyPress Doc at a time, an automatic timer logs out inactive editors to prevent inaccessibility. We are especially proud to bring this feature to you as it has been our most requested development project by the community. You may have already discovered that this new feature is highlighted by a yellow tag describing the changes made and indicating where to go to explore these changes. This notice will remain until you dismiss it by selecting ‘Dismiss this notice.’ More information about the feature and testing feedback can be found here. [...]

Leave a Reply

Your email address will not be published. Required fields are marked *

You may use these HTML tags and attributes: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>