=== bbPress String Swap === Contributors: daveshine, deckerweb Donate link: http://genesisthemes.de/en/donate/ Tags: bbpress, bbPress 2.0, title, forums title, forums archive, breadcrumb, breadcrumbs arguments, strings, swap, frontend, deckerweb Requires at least: 3.4 Tested up to: 3.4.2 Stable tag: 1.0.0 License: GPLv2 or later License URI: http://www.opensource.org/licenses/gpl-license.php In bbPress 2.1+, change Forums Archive Title (forums main page), some Breadcrumbs arguments, User Role display names plus a few other Forums Strings. == Description == = Simply Changing Text Strings = This **small and lightweight plugin** lets you change the Title of the Forums root view. Plus, I added 3 options for some important (as of my opinion) bbPress Breadcrumb parameters. Additionally, you can change the 4 built-in bbPress Forum User Role names. And finally, I've added 5 other important (again, as of my opinion) forum strings used in various Forum, Topic and Reply views. -- **Change all 13 strings *easily* on the bbPress main settings page**! = Main Benefits of this Plugin = * Fine tune your strings and display for YOUR FORUM USE CASE and used theme/templates! * Quick and easily adjust settings via *bbPress Main Settings* page. * Change strings independently from translation files. * Change strings as often as you want to :-) = General Features = * Change *Forums Archive Title* (in root view) - default: `Forums` * Change *Breadcrumbs: Home Text* - default: `Home` * Change *Breadcrumbs: Root Text* - default: `Forums` * Change *Breadcrumbs: Separator* - default: `›` * Change *User Role Display: Key Master* - default: `Key Master` * Change *User Role Display: Moderator* - default: `Moderator` * Change *User Role Display: Member* - default: `Member` * Change *User Role Display: Guest* - default: `Guest` * Change *Forum String: Posts* - default: `Posts` * Change *Forum String: Started by (user)* - default: `Started by: %1$s` * Change *Forum String: Freshness* - default: `Freshness` * Change *Forum String: Voices* - default: `Voices` * Change *Forum String: Submit* - default: `Submit` * If settings fields are left blank, plugin display the original default values :) * Fully WPML compatible. * Fully Multisite compatible, you can also network-enable it if ever needed (per site use is recommended). * Tested with WordPress versions 3.4+ - also in debug mode (no stuff there, ok? :) = Requirements = * WordPress 3.4 or higher * bbPress 2.1 or higher = Important Note Regarding Themes/ Plugins = * If your current theme or other plugins change appropiate filters this could lead to not display any or all changes made by this plugin (though it's not harmful!). * Some themes (especially bbPress compatible ones from 'ThemeForest' marketplace) come with own templates for bbPress and also change other display things (for example breadcrumb behavior) and functions... This could also lead to not display any or all changes made by this plugin. You then have to make the wished changes manually via the theme's templates or simply just call the support of its creator for further advise. = Localization = * English (default) - always included * German (de_DE) - always included * .pot file (`bbpress-string-swap.pot`) for translators is also always included :) * Easy plugin translation platform with GlotPress tool: [Translate "bbPress String Swap"...](http://translate.wpautobahn.com/projects/wordpress-plugins-deckerweb/bbpress-string-swap) * *Your translation? - [Just send it in](http://genesisthemes.de/en/contact/)* [A plugin from deckerweb.de and GenesisThemes](http://genesisthemes.de/en/) = Feedback = * I am open for your suggestions and feedback - Thank you for using or trying out one of my plugins! * Drop me a line [@deckerweb](http://twitter.com/#!/deckerweb) on Twitter * Follow me on [my Facebook page](http://www.facebook.com/deckerweb.service) * Or follow me on [+David Decker](http://deckerweb.de/gplus) on Google Plus ;-) = Tips & More = * *Plugin tip:* [My bbPress Toolbar / Admin Bar plugin](http://wordpress.org/extend/plugins/bbpress-admin-bar-addition/) -- a great time safer and helper tool :) * [Also see my other plugins](http://genesisthemes.de/en/wp-plugins/) or see [my WordPress.org profile page](http://profiles.wordpress.org/daveshine/) * Tip: [*GenesisFinder* - Find then create. Your Genesis Framework Search Engine.](http://genesisfinder.com/) == Installation == 1. Upload the entire `bbpress-string-swap` folder to the `/wp-content/plugins/` directory -- or just upload the ZIP package via 'Plugins > Add New > Upload' in your WP Admin 2. Activate the plugin through the 'Plugins' menu in WordPress 3. On the regular bbPress settings (look under 'Settings > Forums') scroll down to the new section "Plugin: bbPress String Swap" and adjust your settings. 4. Enjoy the new wording for your forums :) = Requirements = * WordPress 3.4 or higher * bbPress 2.1 or higher **Note for own translation/wording:** For custom and update-secure language files please upload them to `/wp-content/languages/bbpress-string-swap/` (just create this folder) - This enables you to use fully custom translations that won't be overridden on plugin updates. Also, complete custom English wording is possible with that, just use a language file like `bbpress-string-swap-en_US.mo/.po` to achieve that (for creating one see the tools on "Other Notes"). == Frequently Asked Questions == = Can I Change More Strings, for Example String 'Xyz'? = No, not yet. The plugin just uses currently available filters in bbPress 2.1+ plus the WordPress Gettext filter for a few other strings. So I'll only add new settings for more strings if there is an original bbPress filter/ hook available and if a setting really makes sense for some use cases (to slim down Gettext filter usage!). -- MORE and/or very special stuff could also be changed via a translation language file for bbPress and/or via WordPress' native gettext filter (see here for more info on that: [Pippin's Plugins, Introduction to the Gettext Filter](http://pippinsplugins.com/introduction-gettext-filter-wordpress/)). = The Plugin's Settings Have No Effect in My Install!? = *Sadly, this could be true in some cases:* * If your current used theme or other third-party plugins change appropiate filters this could lead to not display any or all changes made by this plugin (though it's not harmful!). * Some themes (especially bbPress compatible ones from 'ThemeForest' marketplace) come with own templates for bbPress and also change other display things (for example breadcrumb behavior) and functions... This could also lead to not display any or all changes made by this plugin. You then have to make the wished changes manually via the theme's templates or simply just call the support of its creator for further advise. == Screenshots == 1. bbPress String Swap plugin section on the bbPress main settings page ([Click image for larger version of screenshot](http://s.wordpress.org/extend/plugins/bbpress-string-swap/screenshot-1.png)) 2. bbPress String Swap on the frontend: Forums Archive (root view) 3. bbPress String Swap on the frontend: a single Forum view ([Click image for larger version of screenshot](http://s.wordpress.org/extend/plugins/bbpress-string-swap/screenshot-3.png)) 4. bbPress String Swap on the frontend: a single Topic view ([Click image for larger version of screenshot](http://s.wordpress.org/extend/plugins/bbpress-string-swap/screenshot-4.png)) 5. bbPress String Swap on the frontend: changed submit button 6. bbPress String Swap - plugin's help tab on bbPress settings page ([Click image for larger version of screenshot](http://s.wordpress.org/extend/plugins/bbpress-string-swap/screenshot-6.png)) == Changelog == = 1.0.0 (2012-09-10) = * Initial release == Upgrade Notice == = 1.0.0 = Just released into the wild. == Plugin Links == * [Translations (GlotPress)](http://translate.wpautobahn.com/projects/wordpress-plugins-deckerweb/bbpress-string-swap) * [User support forums](http://wordpress.org/support/plugin/bbpress-string-swap) * *Plugin tip:* [My bbPress Toolbar / Admin Bar plugin](http://wordpress.org/extend/plugins/bbpress-admin-bar-addition/) -- a great time safer and helper tool :) == Donate == Enjoy using *bbPress String Swap*? Please consider [making a small donation](http://genesisthemes.de/en/donate/) to support the project's continued development. == Translations == * English - default, always included * German (de_DE): Deutsch - immer dabei! [Download auch via deckerweb.de](http://deckerweb.de/material/sprachdateien/bbpress-forum/#bbpress-string-swap) * For custom and update-secure language files please upload them to `/wp-content/languages/bbpress-string-swap/` (just create this folder) - This enables you to use fully custom translations that won't be overridden on plugin updates. Also, complete custom English wording is possible with that, just use a language file like `bbpress-string-swap-en_US.mo/.po` to achieve that (for creating one see the following tools). **Easy plugin translation platform with GlotPress tool:** [**Translate "bbPress String Swap"...**](http://translate.wpautobahn.com/projects/wordpress-plugins-deckerweb/bbpress-string-swap) *Note:* All my plugins are internationalized/ translateable by default. This is very important for all users worldwide. So please contribute your language to the plugin to make it even more useful. For translating I recommend the awesome ["Codestyling Localization" plugin](http://wordpress.org/extend/plugins/codestyling-localization/) and for validating the ["Poedit Editor"](http://www.poedit.net/), which works fine on Windows, Mac and Linux. == Additional Info == **Idea Behind / Philosophy:** I've come across some user requests to change the title of the forums archive (a.k.a. root view). When researching for the proper filter for changing this I thought it would be handy to also change a few important breadcrumb parameters along with the title :). So this plugin was born. Nothing spectacular, though. Maybe a few other strings will be added in the future (only if it makes sense!).