Codex Home → Languages and Translations → Persian – Farsi (fa_IR)
Persian – Farsi (fa_IR)
BuddyPress translations can be downloaded at bp-parsi.com while awaiting confirmation at the official translation repository at https://translate.wordpress.org/projects/buddypress/dev/fa/default
Download Persian translation
Codex Home → Getting Started → Customizing
Customizing
There are various ways to customize your BuddyPress site:
BuddyPress plugins in the WordPress.org repository
create your own plugin or
develop a custom theme
The BuddyPress forums offer up many code snippets and solutions from the community to help you add that extra functionality.
External Resources
http://wordpress.stackexchange.com/questions/tagged/buddypress
Codex Home → Legacy Docs → Archived Section: Getting Started → Configuring Components
Configuring Components
Archived file. Good up to BP 1.6.5
Settings > BuddyPress > Components panel
Settings > BuddyPress > Pages panel
Settings > BuddyPress > Settings panel
Settings > BuddyPress > Forums panel
Users > Profile Fields panel
Activity Streams admin panel
Settings > BuddyPress > Components
Only the xProfiles and Activity Stream components are enabled by default. You can selectively enable any of the components by using the form and saving your choices.
Available Components
Each component has a unique purpose, and your community may not need each one.
Extended Profiles
Customize your community with fully editable profile fields that allow your users to describe themselves.
Account Settings
Allow your users to modify their account and notification settings directly from within their profiles.
Friend Connections
Let your users make connections so they can track the activity of others and focus on the people they care about the most.
Private Messaging
Allow your users to talk to each other directly and in private. Not just limited to one-on-one discussions, messages can be sent between any number of members.
Activity Streams
Global, personal, and group activity streams with threaded commenting, direct posting, favoriting and @mentions, all with full RSS feed and email notification support.
User Groups
Groups allow your users to organize themselves into specific public, private or hidden sections with separate activity streams and member listings.
Discussion Forums
Full-powered discussion forums built directly into groups allow for more conventional in-depth conversations. NOTE: This will require an extra (but easy) setup step.
Site Tracking
Make BuddyPress aware of new posts and new comments from your site.
N.B. 「Network mode」 is a feature of WordPress that needs to be manually enabled and configured first. Instructions for enabling this can be found on the WordPress codex WP Codex – Create A Network
Required Components
The following components are required by BuddyPress and cannot be turned off.
BuddyPress Core: It『s what makes [time travel] BuddyPress possible!
Community Members: Everything in a BuddyPress community revolves around its members.
Settings > BuddyPress > Pages
BuddyPress components are rendered as WordPress Pages in BuddyPress. You』ll recall that the above Pages were created and associated to respective BP components in Step 2 of the Installation Wizard.
Directories
Associate a WordPress Page with each BuddyPress component directory.
Activity Streams
Discussion Forums
User Groups
Members
Registration
Associate WordPress Pages with the following BuddyPress Registration pages.
Register
Activate
Settings > BuddyPress > Settings
Disable BuddyPress to WordPress profile syncing? (default: No)
Hide admin bar for logged out users? (default: No)
Disable avatar uploads? Gravatars will still work (default: No)
Disable user account deletion? (default: No)
Disable activity stream commenting on blog and forum posts? (default: No)
Restrict group creation to Site Admins? (default: No)
Settings > BuddyPress > Forums
Three choices are available: Group Forums only, Sitewide Forums only, or Group and Sitewide Forums. Proceed to the illustrated step-by-step guide to set up both forums.
Users > Profile Fields
Your users will distinguish themselves through their profile page. You must give them profile fields that allow them to describe themselves in a way that is relevant to the theme of your social network.
Note: Any fields in the first group will appear on the signup page.
Arrange profile fields by drag and drop
Move fields to different field groups by dragging onto tab
Activity Stream Admin Panel
Codex Home → Legacy Docs → Archived Section: Theme Development → Installing a Compatible Theme
Installing a Compatible Theme
Archived file. Good only up to BP 1.5 version
After you activate BuddyPress, you』ll get this message under the header of the Plugins page:
BuddyPress is ready. You'll need to activate a BuddyPress compatible theme to take advantage of all of the features. We've bundled a default theme, but you can always install some other compatible themes or upgrade your existing WordPress theme.
Activate a BuddyPress compatible theme
This link goes to your admin themes page where you can activate the bp-default theme to test drive the different BuddyPress components that you, as Super/Site Admin, chose to enable for your community.
Note:
If you want to modify or customize the bp-default theme, build a child theme instead to ensure that your revisions will not be overwritten when you upgrade BuddyPress.
Install some other compatible themes
This link goes to a special theme installation page listing all BuddyPress-compatible themes and child themes of the bp-default theme which have been accepted in the WordPress Themes repository and are ready to install and activate in your site.
Notes:
1. BuddyPress themes and bp-default child themes are also available at:
https://wordpress.org/extend/themes/tags/buddypress
https://buddypress.org/extend/themes/
2. Make sure that the theme you want to install is compatible with the WordPress/BuddyPress versions you have activated in your installation.
BP 1.1.3 compatible themes are not compatible with BP 1.2+ installations.
New functions/features contained in WP 3.0 compatible themes will not work with WP/MU 2.9.2 installations
Upgrade your existing WordPress theme
This link goes to a new BuddyPress admin panel where you can automatically install the BP Template Pack plugin to integrate BuddyPress component templates into your active WordPress theme.
https://codex.buddypress.org/extending-buddypress/wordpress-to-buddypress-theme/
Codex Home → Getting Started → Customizing → Installing BuddyPress Plugins
Installing BuddyPress Plugins
Plugins which extend BuddyPress are available at:
https://wordpress.org/extend/plugins/tags/buddypress
https://buddypress.org/extend/plugins/
Make sure that the plugin tagged as 「buddypress」 is compatible with the BP/WP version activated in your server. Note that some BuddyPress plugins require PHP 5+. Also note that when extending BuddyPress using various 3rd party plugins and themes acquired in the WordPress repo or elsewhere, it is advisable to check against other plugins and registration upon activating each individual plugin and/or theme. Reason being is that some plugins and themes do not always play well with certain BuddyPress plugins, themes and the registration. So by using a process of elimination by testing each plugin and theme individually you will avoid having to go through many plugins at one time trying to find the culprit that causes a conflict within your installation.
[This article is still incomplete and will be expanded at a later time.]
Codex Home → BuddyPress Theme Development → bp-custom.php
bp-custom.php
You』ve probably heard a lot of talk about a bp-custom.php file on the BuddyPress forums or WordPress forums.
So what is it?
bp-custom.php is a file that resides in your WordPress 『plugins』 folder where you can add a bunch of custom code hacks and modifications to BuddyPress.
bp-custom.php is often compared to your theme』s functions.php file.
However, there are two primary differences between bp-custom.php and your theme』s functions.php.
First, bp-custom.php runs from the /wp-content/plugins/ folder and is therefore independent from your theme. This is useful for adding code snippets that are BuddyPress-specific. Also, this code will always load regardless of what theme you are using.
Secondly, bp-custom.php runs early in the BuddyPress-loading process. This allows you to override various settings in BuddyPress.
Choosing which file to place your code snippet in is largely a matter of choice. If you are packaging a BuddyPress theme, then you might want to consider using your theme』s functions.php instead. However, for the most part, you should use bp-custom.php.
Creating your file
bp-custom.php does not exist by default. If you don』t have a file located at /wp-content/plugins/bp-custom.php, go ahead and create a blank file with the following:
Next, save the file as 「bp-custom.php」 and verify that this file is located at /wp-content/plugins/.
Now, when you encounter a forum thread telling you to put a code snippet in bp-custom.php, you』ll know what to do!
Examples
Removing the links automatically created in a member』s profile
This can be done by adding the following function to the bp-custom.php file.
BP 1.2.9
function remove_xprofile_links() {
remove_filter( 'bp_get_the_profile_field_value', 'xprofile_filter_link_profile_data', 50, 2 );
}
add_action( 'plugins_loaded', 'remove_xprofile_links' );
BP 1.5 +
function remove_xprofile_links() {
remove_filter( 'bp_get_the_profile_field_value', 'xprofile_filter_link_profile_data', 9, 2 );
}
add_action( 'bp_init', 'remove_xprofile_links' );
Defining custom slugs
Developers may modify the default URL slugs for activity, forums, etc by adding a statement in the bp-custom.php file.
// change 'discuss' to whatever you want
define( 'BP_FORUMS_SLUG', 'discuss' );
See the customizing labels messages and urls article for more information on modifying slugs.
Codex Home → Getting Started → Frequently Asked Questions → Backing Up Your Database and Files
Backing Up Your Database and Files
Backing up your database and site files on a regular basis is one of the best practices to maintain your site. Backups of the database as well as the site』s folders and files in the server are essential to recover from a disaster such as hardware failure or if your site is compromised.
There are a number of approaches you may take to backup:
Hosting control panels
If your site』s hosting provides a control panel e.g Cpanel, Plesk, or Helm, then you should have backup available as a selectable option. Log in to your control panel, locate the item, review it』s options and enable it; generally it will backup both your site files and database and it will do this as a scheduled task which also rotates the backup i.e after a certain number of backups the task will then create the next set of backups and overwrite the first ones made, this way you have backups that will cover a certain period, typically this might be a week worth, so from any given day you should have backups that cover the previous six days.
With 『Rotating』 backups it』s worth bearing in mind that they dictate a window of opportunity in which you may recover or restore files in case of problems and as such, you need to keep a close eye on your site on a regular basis during the period your backup covers before being rotated. For example, if you have a problem on a Tuesday you have only Monday』s backup to revert to if you haven』t noticed the issue by the time next Monday comes around the good backup will be overwritten and you have lost the opportunity.
Manual Database backups
If you have a tool such as phpMyAdmin made available to you, you might choose to take a manual backup of a site』s database to download and store off site which is the recomended practice. Keeping backups in the same hardware they were taken from negates the usefulness of backups in the event of hardware failure.
A full database backup will pretty much help you recover your site in almost its entirety. For complete recovery, you』d also need to backup or download your site』s files and folders from the server. These static files includes uploaded media like images, PDFs, and other documents which you attached to your Posts/Pages.
The procedure for making a manual database backup has been well documented in the WordPress Codex: codex.wordpress.org/Backing_Up_Your_Database
WordPress Admin Dashboard / Backend Export
WordPress provides a means of exporting your posts, pages, comments, custom fields, categories, and tags.
Navigate to admin menu 『Tools > Export』 option and select all that you want to export. Save the exported file off site. Caveat: this is not a replacement for a full backup regimen, it only backups content which does not include database information on the site configuration. This method is best viewed as a quick means of restoring a few posts that may have been lost and can』t be recovered from the posts revisions table. Under the principle outlined below that one can』t be too safe, it is advisable to use this facility from time to time. **Note this method does NOT export your BuddyPress data, but only WordPress blog entries, comments and users
VaultPress
Update: VaultPress is owned by Automattic. As of Version 1.0+, it supports normal BuddyPress installations.
For complete peace of mind it may be worth considering the monthly subscription to the VaultPress service which continually monitors and backs up your site, files and database, and allows very simple restores in the event of a disaster. This provides a level of security and comfort worth every penny. See: VaultPress Features | VaultPress Plans
Backup often – be safe, not sorry
Generally there is no such thing as too many backups. It』s very easy to think that you have covered the process and are safe but it is good practice to keep multiple backups that cover the same data and keep them in different locations. If possible, download your site』s folder and files via s/ftp to your localhost machine, copy those files to a secondary devise such as usb drive, NAS drive, pen drive, etc. Do the same with your database backups … keep multiple copies of them on iifferent storage locations where possible.
Codex Home → Getting Started → Deleting BuddyPress
Deleting BuddyPress
So you』ve decided to stop using BuddyPress. That』s too bad. If something went wrong during your installation or if you ran into its 「limitations」 make sure to check out:
– The Support Forum for help
– The Plugin Directory for awesome BuddyPress plugins.
If you still want to stop using BuddyPress you can just follow these steps below.
Step 1: Disable all BuddyPress related plugins.
It』s a good idea to start with disabling and removing all the plugins on your site which need BuddyPress to function. Certain older plugins might give you a blank page when being active without BuddyPress being enabled. Go to your admin panel and visit the Plugins page. Disable all the plugins related to BuddyPress.
Step 2: Disable BuddyPress and delete the plugin files.
Once again go to your Plugin page and disable BuddyPress the same way as you disable the BuddyPress related plugins. Click the 「disable」 button and you now have disabled BuddyPress.
If you encounter a white page after disabling BuddyPress take a close look at your plugins. Are you sure none of them need BuddyPress to function? If you』re sure that no BuddyPress related plugins are active check if the currently active Theme is not a BuddyPress Theme. If you do have a BuddyPress Theme as your active theme, rename or delete the theme from your Theme folder, so that WordPress resets to the default theme.
Finally you can remove the BuddyPress files by clicking on the 「delete」 button on the plugin page.
You have now successfully removed BuddyPress!
Advanced Optional Step: Removing the database tables
Warning: Make sure to backup your database first! Making a mistake during this process can result in a broken or entirely removed database! If you are not comfortable using PHPMyAdmin do not even go here. Mistakes are made fast so be careful! A guide to backing up a WP DB can be found here: codex.wordpress.org/Backing_Up_Your_Database
Open up PHPMyAdmin through your webhosting panel (cPanel, Plesk or any other system) and visit your WordPress database. Select all the database tables that have WP_BP_ as prefix. If you have chosen a different table prefix during your WordPress installation they can be named differently. The structure is always like this: [table prefix]_BP_
If you have BuddyPress dependent plugins installed you might want to scan your database for any additional unneeded tables, but make sure you』re not dropping a table which is needed for a plugin to function!
When you』ve selected all these tables use the dropdown at the bottom of the page and select 「Drop Tables」 and press the 「Go」 button.
BuddyPress is now completely removed including its database tables.
Advanced Optional Step: Removing BuddyPress』 options from the wp_options table
Warning: Make sure to backup your database first! Making a mistake during this process can result in a broken or entirely removed database! If you are not comfortable using PHPMyAdmin do not even go here. Mistakes are made fast so be careful! A guide to backing up a WP DB can be found here: codex.wordpress.org/Backing_Up_Your_Database
N.B. An additional step that you might like to take if editing tables and working in phpMyAdmin is to use it』s ability to make a full copy of an existing DB under a new name, doing this allows you to simply switch your wp-config DB entry to point to the copied DB for a quick recovery should things go wrong; you are, however, still advised to take a sql backup dump as well for total peace of mind.
Open up PHPMyAdmin through your webhosting panel (cPanel, Plesk or any other system) and visit your WordPress database.
Navigate to the WordPress options table. (By default, this is the 「wp_options」 table, but might be different if you changed your database prefix.)
Next, find the following entries under the option_name column:
bp-db-version (for BuddyPress 1.5)
_bp_db_version (as of BuddyPress 1.6)
bp-active-components
bp-blogs-first-install
bp-deactivated-components
bp-disable-account-deletion
bp-disable-avatar-uploads
bp-disable-blogforum-coments
bp-disable-profile-sync
bp-pages
bp-xprofile-base-group-name
bp-xprofile-fullname-field-name
And delete them from the database.
Codex Home → Getting Started → Importing Data
Importing Data
Importing from Ning
Many users have been interested in being able to import their Ning social network into BuddyPress. This has been even more true since Ning started charging to use their service. Much of the heavy lifting of importing your Ning network to BuddyPress can be done using this Import from Ning Plugin.
Codex Home → Getting Started → Exporting Data
Exporting Data
There is currently no plugin available to export your BuddyPress site data.
However, it is possible to manually execute a database dump to export your data.
