AppBuddy Setup

AppBuddy allows your app to display any page from  BuddyPress, essentially adding a social network component to your app.

Installing the AppBuddy extension.

  1. Download the plugin zip file from your AppPresser account page. Login to your WordPress site and go to Plugins => Add New => Upload. Upload and activate AppBuddy.
  2. You will now find a new "AppBuddy" tab in your AppPresser settings. Please visit there to configure the extension's settings.

Configuring AppBuddy.

AppBuddy currently has limited configurable settings from the settings page.

  1. AppBuddy License Key
    • Add the license key you received, with your purchase, here. This will enable you to receive updates for the plugin as we release them.
  2. AppCam
    • Use this setting if you want to allow users to be able to attach images to their BuddyPress status updates.
  3. AppPush
    • Use this setting if you want to allow Push Notifications for private messages, friend requests, and mentions.

Customizing AppBuddy Template Files

AppBuddy is powered by BuddyPress template files the same way that BuddyPress is in your standard WordPress install. Because of that, it's also customizable the same way. You will find the AppBuddy copies of the files in  /wp-content/plugins/appbuddy/templates/buddypress/. If you would like to customize any (or all of them), just recreate the same hierarchy in your chosen theme to use with AppPresser.

If you want to customize all of them, place the  /buddypress/ folder and all of the contents into your theme. If you want to just customize a certain part of it, just copy the specific file(s) over. For example, the activity loop, you would make a copy of /buddypress/activity/activity-loop.php and place it into your chosen theme like so: /wp-content/themes/THEME-NAME-HERE/buddypress/activity/activity-loop.php. Then you would edit that file as you need, and it'll be the chosen file when your users visit the activity page.

For more information on customizing BuddyPress themes, please visit the  BuddyPress Themes Codex Page and for more information on customizing BuddyPress as a whole, visit BuddyPress Codex

Since we copied the core BuddyPress templates directly, all of the same BuddyPress hooks should still be present and usable. You will need to add already existing hooks that you have to your AppPresser chosen theme.

Login

By default, when AppBuddy is active it requires a login to see your app. You can turn this off by placing the following define in wp-config.php.

define( 'APPP_REMOVE_LOGIN', true);

Translation

Translation files are located in the /languages folder. For more information on translating your extension, please see  Translating WordPress and Translating AppPresser. The text domain used for AppBuddy is appbuddy.

URLs to BuddyPress pages - /me/

Requires AppBuddy 3.1.0
AppBuddy allows you to use /me/ as part of any URL to redirect to a user's activity, profile or any other BuddyPress page where their user name appears in the URL.  The user need to be logged in for the redirect to work; otherwise, they will be redirected to the homepage and the login modal will appear.  There are two filters for this feature: ap3_bp_me_url and ap3_loginmodal_url. For example a you can use a URL like yourdomain.com/members/me/ and it will redirect to yourdomain.com/members/mickeymouse/ when Mickey is logged in.

AppBuddy Hooks

toolbar_button_right

Type: Action | File: inc/AppBuddy_Modal_Buttons.php | Since: 1.0.0

Adds right toolbar button

appbuddy_modal_button

Type: Filter | File: inc/AppBuddy_Modal_Buttons.php | Since: 1.0.0

Default Value:

sprintf( '<a href="%s"><i></i> %s</a>', $this->args['button_class'], $this->args['url'], $this->args['icon_class'], $this->args['button_text'] )<br>
	

active_plugins

Type: Filter | File: appbuddy.php | Since: 1.0.0

Allows you to intercept get_option( 'active_plugins' ) before our extension determines if the required plugins are presently active.

Default value:

get_option( 'active_plugins' ) //Saved value from your WP install. Not specific to AppPresser<br><br>
	

ap3_bp_me_url

Type: Filter | File: inc/AppBuddy_ProfileRedirect.php | Since: 3.1.0

Allows you to redirect a BuddyPress user to pages where the URL contains their username.  For example a you can use a URL like yourdomain.com/members/me/ and it will redirect to yourdomain.com/members/mickeymouse/ when Mickey is logged in.  If you would prefer to use a different placeholder instead of '/me/' use the ap3_bp_me_url filter.

ap3_loginmodal_url

Type: Filter | File: inc/AppBuddy_ProfileRedirect.php | Since: 3.1.0

Used with the feature when using the '/me/' as part of the URL to redirect a BuddyPress user to pages where the URL contains their username.  If the user is not logged in, by default it will redirect them to the homepage and open the login modal in the AP3 Ion theme.  To change what page you want the loginModal to appear use the ap3_loginmodal_url filter.