This documentation is for AppPresser 2 only. For AppPresser 3 docs, click here.

AppBuddy Setup

Install AppBuddy | AppPresser Documentation

If you have ever set up your own "social network" or community using BuddyPress and WordPress, then chances are you have wished, even just in the back of your head, that you could have your community members interact with each other no matter where they are and what device they have in their hand. If you heard about AppPresser earlier this year, you may have thought "Wow, that would help out a lot, but they do not have BuddyPress support!". With the pending official release of AppBuddy, you will now be able to tie your community into a WordPress powered smartphone app. Now your users will be able to interact with your finely crafted community all within a dedicated app.

Installing the AppBuddy extension.

  1. Install and activate the AppBuddy extension that you purchased from AppPresser Extensions.
  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.

Customizer

The customizer has a section for AppBuddy added to it. There you will find three appearance based items to configure

Login screen background color

Set a custom color for the background of the login page.

  • Login screen background image

Set a custom background image for the login page.

  • Login screen text

Set some custom text to display at the top of the login page.

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.

PressChat

We made our own customized app using AppBuddy called PressChat, and added a few features that you can use in your own app. Read about our customizations, and get a free child theme in our blog post here.

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.

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 class="%s" href="%s"><i class="%s"></i> %s</a>', $this->args['button_class'], $this->args['url'], $this->args['icon_class'], $this->args['button_text'] )
				

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