appear.in WP

Description

Harness the power of appear.in by embedding secure peer-to-peer video chat rooms on a self-hosted WordPress site via the [appear_in] shortcode.

In order for this plugin to operate properly within a Chrome browser, the shortcode must be embedded on a webpage served with the HTTPS protocol.

Shortcode

[appear_in]

Shortcode Attributes

  room="_custom-public-room-name_"

type=”public,private,post” (default: public)
public_room_button=”” (default: Public Room)
private_room_button=”” (default: Private Room)
post_room_button=”” (default: Post Room)
position=”left,bottom,inline” (default: left)
height=”int

Set a custom public room name, specify which room buttons are shown on a page, change the button text, determine where rooms will be displayed, and set height of inline rooms.

Settings

Custom settings for appear.in WordPress are found on the Settings > Media admin page.

* **Room Button Color**
* **Public Room Name:** define a public room name for default use in shortcode

If a public room name has not been explicitly defined in settings or shortcode, then the default public room expires daily.

The 'post' room type will generate a public room with name of the current post.

Features

Button for toggling room visibility.
Button for toggling room position.
Buttons for inviting others via Twitter, Facebook, and email.

Functions

The following function can be used to include rooms:

aiwp_include( $args );`

Default arguments:

$args = array(
    'room'                  => '',
    'type'                  => 'public',
    'public_room_button'    => 'Public Room',
    'private_room_button'   => 'Private Room',
    'post_room_button'      => 'Post Room',
    'position'              => 'left',
);

Filters

aiwp_unsupported_browser_message
aiwp_room_button

Constants

AIWP_SHOW_TOGGLE
AIWP_SHOW_INVITE

Documentation

Documentation and implementation can be viewed here.

Learn more about appear.in – a product of Telenor Digital AS built with WebRTC technologies.

Screenshots

  • appear.in WordPress Settings
  • Active appear.in Embedded Room

Installation

  1. Upload the appear-in-wp directory to /wp-content/plugins/
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Ensure pages are served via HTTPS.

FAQ

Silence is golden.

Installation Instructions
  1. Upload the appear-in-wp directory to /wp-content/plugins/
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Ensure pages are served via HTTPS.

Contributors & Developers

“appear.in WP” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

2.8

  • Please note: As of June 30, 2017, the appear.in embed & developer SDK is being deprecated. Thus, the appear.in WP plugin can no longer serve to embed rooms.

2.7

  • Bump compatibility to WP 4.6

2.6

  • Redirects to app on iOS
  • Removes protocol from post room names

2.5

  • Fix for hidden controls when toggling position

2.4

  • Utilizes new API calls
  • Adds option to position room fied to left (new default)
  • Adds option to toggle room position between bottom and left
  • Repositions plugin function buttons

2.3

  • Adds shortcode option to position room – defaults to bottom fixed
  • Allows toggling visibility of active rooms
  • Adds shortcode option to set height of inline room
  • Overlays invite buttons on room

2.2

  • Fix display of notices in admin
  • Fixes invitation URLs when using default permalink structure
  • Auto-scrolls browser to the room when visiting from an invite
  • Checks brightness of button color and sets text color accordingly

2.1

  • A fix when embedding on secure sites

2.0

  • Replaced email invitation form with social invitations (Facebook, Twitter, Email)
  • Removed stats
  • Added option to select button color

1.8

  • Readme edit

1.7

  • Added confirmation to leave once a session has been triggered
  • CSS edits
  • Added link to the non-embedded, full room at appear.in
  • Fixed call to ajaxurl in certain situations.

1.6

  • Fixed various PHP notices

1.5

  • Added display of local invitation URL
  • Updated side notice class
  • Readme edits

1.4

  • Modified & Refined filters
  • Added shortcode parameters for button text

1.3

  • Refined filters
  • Added room type parameter to shortcode (defaults to public)
  • Removed allowed types from options
  • Added number of allowable invites parameter to shortcode
  • Added room type ‘post’
  • Added ‘aiwp_include’ function for use in themes
  • Fixed call to included files

1.2

  • Minor readme edit to show correct version
  • Removed function used during development

1.1

  • Adding repository images

1.0

  • Initial Release