I’ve enabled markdown on this P2, because markdown is cool.
Recent Updates Toggle Comment Threads | Keyboard Shortcuts
-
Mercime
BP Codex Updates
Many thanks to the following developers for their new codex articles:
@imath – http://codex.buddypress.org/plugindev/group-meta-queries-usage-example/
@chouf1 – http://codex.buddypress.org/developer/buddypress-database-diagram/ with thanks to @boonebgorges for the consults
@chouf1 – http://codex.buddypress.org/developer/how-to-add-members-to-a-group-via-wp-users-screen/
@hnla – http://codex.buddypress.org/themes/theme-compatibility-1-7/bp-default-theme-moving-forward-with-bp-1-9/
@imath – http://codex.buddypress.org/plugindev/enqueueing-scripts-or-styles-only-when-your-plugin-needs-it/
If you’d like to contribute to the BuddyPress Codex, please check out the references below
- BP Codex Standards and Guidelines – Basic instructions for contributing to the Codex
- BP Codex Table of Contents – Google spreadsheet updated regularly
- Upcoming Codex Articles – Google docs updated regularly
BuddyPress Translations
A quick audit of all the codex pages under BuddyPress Languages/Translations reveal that only a handful of pages have links to translations for the latest BP version. The large majority of the language pages contained outdated, incorrect and oftentimes confusing information about where to find and download the translation files for the respective languages.
There are translations hosted at translate.wordpress.org/projects/buddypress, some at i18n.svn.buddypress.org (deprecated), one at svn.automattic.com/wordpress-i18n, one at google code, some at personal websites and/or BuddyPress Group websites. We need to consolidate all the translations in one official site so that the end users won’t have any difficulty in finding their respective translation files.
Per our BuddyPress Codex Survey, close to half (44%) of BuddyPress sites are built using languages other than English. There have been questions in the BuddyPress Forums about where to find translations and how to create or submit translations. We need to make it easy for translators to contribute to the BP project. In this respect, a Google spreadsheet re BP translations was created to get a bird’s-eye view about the status of BP translations at this time.
https://docs.google.com/spreadsheet/ccc?key=0AlDyI51JorH3dHFlandCVzk1U3VXeXFMWUtzNEJsSWc#gid=0
BuddyPress Languages/Translations Section To-Do’s
1. For translators: A new page with guide specifically for BuddyPress Translators – check out Zé Fontainhas’s post about Getting Started and Adding Support for a Language for WordPress which includea basic information about translating for WordPress Projects like BuddyPress
2. For users: A new page which lists languages and translators for latest BP versions – a la http://codex.wordpress.org/WordPress_in_Your_Language
3. For both: provide a way to allow users to send feedback to translators.
Please feel free to add your suggestions and/or volunteer to author the step-by-step guide for BP Translators. Thanks.
-
Rob
Is there a way to submit corrections for already ‘translated’ languages? For example in Spanish (Spain) just a quick glance finds this error:
English >>>>>>>>> Spanish (Spain)
Filter Groups or Activity by Metadata >>>>>>> Grupos Filtrados o Actividad de Metadatos
But that is incorrect. It should be “Filtrar Grupos o Actividad por Metadatos”
http://translate.wordpress.org/projects/buddypress/dev/es/default
This one is also wrong:
Superpowered Group Extensions should be “Extension de Grupos Reforzados”
There is no such word in Spanish “Renforzados” (used in the existing translation)!
-
Mercime
Is there a way to submit corrections for already ‘translated’ languages?
Not at this time, but that’s a good idea for consideration.. Added in to-do’s. Thanks.
-
Rob
No problem. It sounds like someone just c/p the English into babelfish or google translate. Which makes it rather awkward.
-
Mercime
Not sure about that. Could be human error or could be Spanish dialect in another part of the country (?). Please be patient, BP translators are all volunteers.
-
-
Stephen Edgar
To submit translation updates go to the translation, enter your translation suggestion and click ‘Submit new translation”, this will then be marked ‘Waiting’ and the Spanish translation validator for BuddyPress will either approve or reject the request.
-
-
Stephen Edgar
The Official, one and only place for BuddyPress translations is at http://translate.wordpress.org/projects/buddypress/
The /dev branch has just been updated today to use BuddyPress /trunk
All the stats for translations are also at eg. http://translate.wordpress.org/projects/buddypress/dev so your spreadsheet only needs to monitor the codex pages status.
The 1.8.x branch for BuddyPress I am not sure if it will be created eg http://translate.wordpress.org/projects/buddypress/1.8.x or if this will be skipped and a 1.9.x branch further details on this can be found in this post http://make.wordpress.org/polyglots/2013/11/17/bbpress-dev-projects-bbpress-dev-is-using/
Requests to be added as a translator should be made on the PolyGlots blog http://make.wordpress.org/polyglots/
As outlined in this post by @nacin http://make.wordpress.org/polyglots/2013/10/02/strings-for-wordpress-3-7-hello-all-i-want/ “Upon 3.7′s launch, any 100% translations for these plugins will be delivered to WordPress sites during updates. The same goes for bbPress, BuddyPress, and default themes, too.” and this is my primary reason I had the English, Australia (en_AU) locale setup, to test and use automatic translations updates for bbPress & BuddyPress.
-
Mercime
Thank you Stephen!
Spreadsheet was result of our audit and we have noted that i18n.svn.buddypress.org/ is deprecated (changed header to light background so that can be seen more clearly). As to 1.8x branch in official repo, not sure as well.-
Stephen
Cool, as I’m going to keep atop of any i18n issues for bbPress I’ll make sure I also keep track of BuddyPress i18n issues also.
-
Mercime
Many thanks Stephen. We appreciate your kind assistance
-
-
Boone B. Gorges
BP 1.9-beta1 is now available. Check it out! http://buddypress.org/2013/11/buddypress-1-9-beta-1-is-now-available/
-
Paul Gibbs
Thanks for packaging this and for so many of your commits recently. You are THE man!
Boone B. Gorges
Since BP 1.7 and the introduction of theme compatibility, BuddyPress has worked seamlessly with pretty much any WP theme. Yet we’ve been continuing to maintain the old bp-default theme, which dates back to when themes needed to be built specifically for use with BP. For the last two release cycles, we’ve maintained more-or-less 100% feature parity between our packaged theme compat templates (bp-legacy) and bp-default. After the release of BP 1.9, this will no longer be the case. In BuddyPress 1.9, we begin the process of phasing out the BuddyPress Default theme. bp-default will continue to be packaged with BuddyPress, and will still receive critical fixes and security updates. However, it will no longer get routine bug fixes or new features.
We’ve made this decision for a number of reasons. First, it simplifies the workflow for BP contributors – patches only need to be written for bp-legacy templates. More importantly, this move encourages BuddyPress users – from developers to site administrators – to stop using the old, buggy method of loading templates (see #5241 for just one recent example of how the old method causes problems). The techniques used by our theme compatibility layer, in contrast, are more robustly integrated with WordPress’s request parsing and template loading systems, and will become even more integrated when we move to using proper WP rewrite rules. In short, theme compat is the future, and the BuddyPress ecosystem will become more stable as people gradually move away from the old themes.
Toward this end, we have, as of [7569], stopped offering bp-default on installations that are not already using it. That means that if your site is not already running bp-default (or a child theme of bp-default), BuddyPress 1.9 will not register its bp-themes directory, and bp-default will not show up on Dashboard > Appearance. This’ll ensure that new installations don’t get locked into using the now-sunsetted bp-default theme.
If you are already using bp-default, either directly or as a parent theme, don’t worry. BuddyPress 1.9 will detect that you need bp-default, and will continue to register it with WordPress. Note that if you switch away from a bp-default theme (say, for testing), the theme will disappear from Dashboard > Appearance. If you need it back, add the following line to your bp-custom.php file:
add_filter( 'bp_do_register_theme_directory', '__return_true' );
In some future release, we’ll aim to remove bp-default altogether from the BuddyPress package. It’ll likely find a new home in the wordpress.org theme repository. We’re working on a method of doing this that’ll be as transparent as possible for existing users of the theme. If you’d like to participate in the conversation about how and when this will happen, follow #5212.
I think I speak for everyone who has worked extensively with bp-default and its derivatives when I say that this is something of a bittersweet moment. bp-default was often a bear to work with, but it also proved to be a remarkably flexible and powerful foundation for building BuddyPress sites. And oh, that beautiful blue header gradient!
-
David Bisset
End of an era, but a solid move forward. This fits perfectly into my session this Saturday on “Thinking Outside The Box w/ BuddyPress” at #wcorl
-
imath
Great post! & “Au revoir” BP Default
David Cavins
Nice job handling the cases where users still need the old theme. It would be really frustrating to have a giant, site-melting change brought about by updating.
Is it too late to rename bp-legacy to something a little more obvious? BP-legacy sounds like it’s intended for users of BP 1.2. Is it accurate to say that the files are a compatibility layer? Would bp-compat make sense, or is that too close to theme-compat?
-
Boone Gorges
David – Thanks for the feedback!
We can’t change the name of bp-legacy – it’s pretty hardcoded at this point. For some background information, the reason why it was named that way is because the basic template structure (the markup itself) was pulled pretty much verbatim out of the old bp-default templates. We knew at the time that this was a sort of interim fix, and that we’d be moving in the future to a new set of templates. See https://github.com/karmatosed/buddypress-templatepack. That’ll have a different name.
-
David Cavins
Ha ha, so it really is a legacy system. In that case, the name is perfect!
-
-
hnla
>Is it accurate to say that the files are a compatibility layer
>Ha ha, so it really is a legacy system
Yes & noThe files in that dir are the ones looked to when BP runs in theme compat mode, however one can overload those to a theme/child theme and re-write that makup as much as one desires.
I wouldn’t refer to the word ‘legacy’ where I can help it yes those files were copied verbatim-ish from bp-default but the crucial aspect of theme compat is the dir structure/file names and the theme class that sets the ball rolling. So no it’s not a legacy system, but BP has to find template files from somewhere with time that somewhere may change when template pack comes to fruition, but as for now simply ignore the word ‘Legacy’
hnla
bp-default served with honour and deserves a well earned rest
This is the right way to go to keep core code and attention focussed on theme compat and not offer too many alternatives to have to consider and support. Moving to WP theme repo would be optimum scenario and short of a few hurdles shouldn’t be too hard to achieve.
-
Boone Gorges
Thanks hnla! Agreed on all counts.
Paul Gibbs
@karmatosed and I spent a little time this morning updating the appearance of this P2 to more closely resemble buddypress.org; the blue was super old.
-
David Bisset
Snappy.
-
slaFFik
What’s the purpose of this sliding big red top bar? As for me it give 0 (zero) functionality, but takes space.
-
Paul Gibbs
Sure, the idea was to spend 30 minutes making bpdevel look more like BuddyPress.org. I don’t know if we can add a nav bar in there, otherwise maybe we could unsticky it.
-
-
slaFFik
and there is a bug with that bar: http://screencast.com/t/0QRqzAQlh49
-
Boone Gorges
Spiffy!
-
imath
This is really nice, bravo !
-
ubernaut
looks great!
-
John James Jacoby
So much better. Thanks for doing this!
-
John James Jacoby
Also, please feel free to do something more radical with the CSS on this P2. Meaning, experiment with future BuddyPress.org stylings too.
-
trishasalas
+1
-
-
-
trishasalas
Looks really good, @karmatosed and @djpaulgibbs!
hnla
A first flurry of new articles have began to arrive at the Codex’s door and the codex team wish to thank those people for their submissions.
Articles have been submitted by:
shanebp buddypress-member-toolbar-menu
PollyPlummer & Luca customizing-buddypress-avatars
dcavins displaying-extended-profile-fields-on-member-profiles | modifying-the-registration-form | preventing-spammer-registration
Also the team thank Sarah for her continued support and encouragement over at WordPress Tavern
We wait with bated breath for the next batch of articles to arrive in and if you are interested in writing for the codex you can still see if any of the suggested articles take your fancy on the codex article list, if one does get in touch and we’ll put your name to it or if you have suggestions please let us know.
-
Rob
Fantastic work! kudos to the team. If I may offer a small suggestion:
please move the codex links from the sidebar and into the main page container. And then please use appropriate h tags to categories them in tree format (h4/h3/h2, etc.)
here’s a screenshot to show you what I mean: http://i.imgur.com/mFY6p4Y.png-
Mercime
>> move the codex links from the sidebar and into the main page container
I agree
-
Paul Gibbs
Can we look at adjusting the dev chat time in a week’s time? Clocks go back this Sunday in the UK, and I believe in places in N America a week after that.
Ideally, I’d like it shifted from 19:00 UTC to 20:00 UTC, but more than happy to hear counter-proposals from others here.
-
ubernaut
isn’t that the same time as the wordpress devchat?
-
mercime
yes, same time – http://make.wordpress.org/core/weekly-developer-chats/
-
-
ubernaut
i think they about to shift the wp-dev chat for daylight savings time in case that matters
-
mercime
Per Nacin: ” the weekly Wednesday meeting is now moved from 20:00 UTC to 21:00 UTC (4 p.m. EDT, 1 p.m. PDT).” http://make.wordpress.org/core/2013/11/01/matt-will-be-running-a-wordpress-3-8-feature/ so no more conflict
-
Paul Gibbs
@johnjamesjacoby @boonebgorges @rayisme Can I get your opinions on a new time? 19:00 UTC isn’t going to work for me.
-
Boone Gorges
2000 UTC is fine for me.
hnla
Codex Progress Update & TOC Re-visited
It’s time for a brief progress report from the codex team on current status of the codex.
Both Mercime and I have been working away on the first phase of the codex: restructuring of existing pages under new sections while also performing the ongoing audit of those existing pages to establish what needed updating or removing, a task in it’s self which is a lot more work than one expects.
In beginning the re-shuffling pf pages under new sections it quickly became apparent that my original fear – and one of the reasons people found pages hard to find – of ending up with pages too deeply nested under sections & sub-sections was coming true; even with our revised TOC we were finding that we were arriving at pages buried four or five clicks in, something that we didn’t really want, we had always wanted pages to be reached as quickly as possible. After agreement that we needed to rectify this Mercime undertook to review this and implement one last revision where the sections were revised to be six top level ones with child pages living directly under, increasing those top sections meant far less nesting and altogether a far better visual layout to menus.
We are happy now that this revision will serve the codex and users well, based as it is on the user feedback we gathered from the codex survey.
The initial phase to clean up and refresh the codex has been completed by the restructuring of the documentation as mentioned above.
The revised TOC has now been created as a google spreadsheet by mercime which is far more helpful in managing things it can be viewed and commented on at this link:
https://docs.google.com/spreadsheet/ccc?key=tOT3Q1oFPiTC-c1MDp1ZtRw#gid=0
We are now working to add the new pages required into this sheet, a fair bit of which is done now and also adding in those members that have kindly offered to write articles. while that happens we also start to look at where we can improve the visual style and menus where applicable and write up a Codex ‘Standards & Guidelines’ to help people who wish to contribute to the Codex in future.
For those who want to contribute, following are lists of outstanding and suggested articles based on user feedback from members. If you want to participate, post a comment below and we’ll note ownership of the article in this post.
So to sum up, things are moving in the right direction, the work is slow but we expected that, it needs to be as thorough as possible to serve the community well.
The codex Team,
hnla, mercime.
-
Paul Gibbs
This is really impressive. Big congratulations and thanks to everyone mentioned in this post!
hnla
Revised Codex TOC Outline
This outline represents a revised version based in part from the feedback received from the recent codex survey. This revised version is subject to the comments and views of everyone and can be updated if sufficient comments concur on an aspect.
Introduction – Primary landing page
The actual codex landing page has been re-factored to follow this outline but can be changed.
Section 1: Intro
Introductory text- possibly stating the obvious? and could be removed?
Section 2: Main codex Areas – linking to parent page for sections.
- For Regular Users
- For Theme Builders
- For Developers
Section 2: Contribute
Guidance on how people can get involved with the BP project – links to two pages ‘Codex formatting guide’ & general Participate & Contribute’ page with full BP project links
Section 3: Version list & changelogs
Links to full list of all BP version releases – updated to include links to zip downloads.
Section 4: Legacy docs – all docs prior to 1.7 are removed to this section
For All Users
Getting Started
- Before Installing
- System & Server Requiremets
- Plugins > Add New
- FTP/cpanel
- Securing install – backups etc ( guide exists)
- The installation process overview
- BuddyPress Components and Features Overview
- Using BuddyPress with WP MultiSite (guide to using BP with MS – how bp functions with subsites) new page
User Guide
Introduction (page parent, right hand sub page menu) -- Configuring BuddyPress
- Settings > BuddyPress > Components
- Settings > BuddyPress > Pages
- Settings > BuddyPress > Settings
- Configuring BuddyPress
- Managing Components
- The registration process ( overview of reg process, email, activation, extending reg fields using xprofile fields) NP
- Activity Stream Admin Panels
- Group Management Admin Panel
For Theme Builders
- Introduction (page parent, right hand sub page menu) – covers the essential principles for building sites / themes e.g. Standalone, working as child theme, clarifies bp-default/bp legacy.
- BP Theme Compatibility 1.7 ( overview section )
- intro to theme compat 1.7
- The template hierarchy in detail
- Upgrading template packed themes to theme compat
- Building themes ( general pages covering actual approaches to theme building )
- An overview on the various approaches one can take in managing BP templates/themes (N)
- BP Default Child Theming
- Working with BP Legacy -Theme Compatibility (N)
- Building from theme compatibility templates in custom theme (N)
- Building themes using Template Pack
- BP Theme Unit Test – ala WP Theme Review Test – BP Default Theme and Twenty Twelve theme – @mercime already started this then stopped to create those BP Component Pages in Codex
- Tutorials(1) ?
For Developers
- Introduction (page parent, right hand sub page menu)
- Template Tags
- Main BP loops, e.g. members loop, activity loop etc.
- Functions list ?
- Conditional Tags
- Building and extending components, working with Queries.
- Extending BP user account screens
- Extending Group component
- Working with the template stack / extending BP_Theme_Compat (N)
- BP_User_Query (N)
- Developing plugins for BuddyPress
- Developing for BuddyPress & WP MultiSite
- Guide to how BP functions with MS – intro page, new.
- User Submitted Tutorials/code snippets –
- Unit Tests
- How To(1) – General ( collects series of shorter examples of how to do something e.g. ‘force ssl admin’)
- develop.buddypress.org (PHPDocs)
Feedback on this proposed structure, suggestions for improvement is welcome and hoped for.
Snipped from the codex survey is this comment Please make something scalable that won’t be obsolete by the time 1.9 comes out! and is something we try and bear in mind moving forward. This codex structural revision needs to be something we can build on and that serves to clearly manage pages under a clear hierarchy that allows people to quickly find the information they are looking for, to that end w welcome comments and feedback on the nature of nesting pages under sections, are there too many? Are pages buried too deeply? based on the old paradigm that any web page should not be more than three or four clicks away how do we stack up on that score?
With the developers section certain information such as references to ‘Actions’ will be provided by PHPDocs to be implemented for the Codex.
-
ubernaut
i like it i would say 2 things:
#1 we should try to make sure that section 2 of the landing/home page is above the fold get people who are looking for answers directly to the nitty gritty. i like the idea of a general overview just saying we should keep that as short as possible.
#2 i would suggestion some general hosting recommendations as well as best practices stuff like fighting spam in the all users section since those are some of the most common issues raised in the forums.
bonus: i think we should make sure to have a very clear tutorial or something relating to how the registration process works, seems like we get a lot of questions pertaining to that as well.
-
hnla
#1 Those sectional links ought to be above the fold unless one has a very small screen.
#2 Personally I’m adverse to any particular recommendation for hosting however we could add some detail on best setups, server specs for a BP site.
#3 Yes we can add a page on registration process I’ll add as new page under ‘for all users > user guide’
-
ubernaut
RE; #2 yeah i wasn’t suggesting making specify host recommendations so much as general server spec guidelines.
-
-
-
hnla
Two new sections added for using BP with MS – under ‘for all user’ > ‘getting started’ & under ‘Developers’
Comments or thoughts on whether worthwhile? Partly prompted by existence of a guide to customizing xprofile fields on a per site basis already published and prompting comment request for feedback below this one.
-
hnla
Comments & feedback required on whether it’s thought a good idea to have ‘Tutorial / How To ‘ sections. Currently we have added Tutorial sections under each main top level sections – if we do run with user submitted tuts or code snippets these will need to be checked over first by an authorised set of devs before publishing to avoid any possible bad practise examples being published.
-
hnla
Codex Curation & Moderation:
Thoughts & feedback sought. Proposal is that Codex must be curated and moderated, we can follow two possible routes to achieving this , allow all aarticles/pages to be written and published by author and rely on retrospectively hoping we are aware of newly published articles so we can check them or we request that authors in the first instance save their work as ‘Draft’ for curators/editors to review and publish, therefater allowing author to continue with revisions or updates as they see fit.
Question: Can the codex email notify of newly drafted pages or published pages as a means of call to action to check over?
-
Paul Gibbs
I don’t like the idea of featuring legacy docs on the front page. It’s just clutter.
I don’t think there’s any point in having a MS section under Developers.Codex needs to remain open for anyone to publish on without moderation. In terms of tracking new pages, how about we add Pages to the (unused) RSS feed?
-
hnla
Yes agree on legacy docs/clutter, question is where do they neatly sit, guess under ‘Developer’ but equally don’t really want them under any of the three prime sections which is why placed them at top level.
The MS section under developers was more that there was an existing page written showing code examples of hacking xprofile to work on a per site basis, and wanted somewhere to place that, equally though it could go under the general tuts for developers but as for general page do we not think there are aspects of MS from a developers point of view that are unique to working in that mode?
Understand the view that Codex needs to be open, but equally do believe that a degree of curation must take place otherwise the codex could end up in the slight jumble it is now that we’re trying to audit. If RSS feed could work in that fashion then that might be a solution. One thing though to bear in mind that if one accepts that order has to be maintained to a degree, then a degree of moderation or curation will at times need to take place, exactly what form that takes is open to discussion and I’ve proposed and drafted(with no detail as yet) a codex guidelines page where we can set out a few do’s & don’t , codex standards etc.
-
-
hnla
Renaming ‘Tutorials’ to ‘HowTo’ to accommodate the number of shorter examples of how to achieve something and that are not quite tutorials, implying something of greater length & detail, for the moment this is just for the Developer section where this is more pertinent.
-
ubernaut
that makes a lot of sense imo
-
Mercime
The 2013 BP Codex Survey report is now available. Read about it at http://buddypress.org/2013/09/2013-buddypress-codex-survey-results/
trishasalas 11:08 pm on November 19, 2013 Permalink |
w00t! for _markdown_
Mercime 1:30 am on November 20, 2013 Permalink |
Thank you Paul. Got the reference chart handy for next post
http://en.support.wordpress.com/markdown-quick-reference/