Wordpress Social Invitations v1.3

Wordpress Social Invitations

Created: 20/05/2013
Updated: 31/05/2013
By: Damian Logghe
Email: info@timersys.com
Website: timersys.com
Twitter: @chifliiiii

Thank you for downloading my plugin. If you have any questions that are beyond the scope of this help file, please feel free to email me or contact me via my contact form on my website. Thanks so much!

For support visit http://timersys.ticksy.com/

Table of Contents

  1. Installation
  2. Configuration
    1. Google
    2. Yahoo
    3. Linkedin
    4. Live, Hotmail, Msn
    5. Facebook
    6. Twitter
    7. Foursquare
  3. Shortcodes
  4. PHP Functions
  5. Hooks & Redirection
  6. Translation
  7. Sources and Credits

A) Installation - top

Move the folder named wordpress-social-invitations (located inside the wsi-plugin folder you just downloaded and extracted from CodeCanyon to your WordPress /wp-content/plugins/ folder.

Navigate to Plugins inside the admin interface of your WordPress website and click Activate for Wordpress Social Invitation. Congratulations! the plugin is now installed and activated.

If you have any trouble with the installation, please feel free to contact me for help.

B) Configuration - top

Once you have installed and activated Wordpress Social Invitations, you can follow this guide for configuring the different providers. Please read it carefully, you will need to properly configure the providers in order to make them work.

1. Google - top

To enable authentication with this provider and to register a new Google API Application, carefully follow the steps :

  1. Go to https://code.google.com/apis/console/ and create a new application.
  2. On the Dashboard sidebar click on API Access then Click "Create an OAuth 2.0 client ID...".
  3. On the "Create Client ID" popup:
    • Choose "Web application"
    • On "Your site or hostname" enter your website url followed by /wp-content/plugins/wordpress-social-invitations/hybridauth/?hauth.done=google. If your site is www.example.com , you need to enter www.example.com/wp-content/plugins/wordpress-social-invitations/hybridauth/?hauth.done=google and that should be shown in the Redirect URI field
    • Click on "Create Client ID" to finish
  4. Once created copy the Client ID and Client Secret to the Wordpress Social Invitations Plugin
Google App

2. Yahoo - top

To enable authentication with this provider and to register a new Yahoo API Application, carefully follow the steps :

  1. Go to https://developer.apps.yahoo.com/dashboard/createKey.html and create a new application.
  2. Fill out any required fields such as the application name and description.
  3. Choose "Web-based" as application type.
  4. On "Access Scopes" choose "This app requires access to private user data".
  5. Enter your website again on the "Application domain" field.
  6. Check "Contacts" API checkbox with Read access.
  7. Accept terms and create project
  8. Optional (but recommended) once the project is created you can verify the domain in https://developer.apps.yahoo.com/manage
  9. Once created copy the API Key and Secret Key to the Wordpress Social Invitations Plugin
Yahoo App

3. Linkedin - top

To enable authentication with this provider and to register a new Linkedin API Application, carefully follow the steps :

  1. Go to https://www.linkedin.com/secure/developer and create a new application.
  2. Fill out any required fields such as the application name and description , website, etc.
  3. Choose "Live" on "Live Status".
  4. Agree with terms and click on Add Application
  5. Once created copy the API Key and Secret Key to the Wordpress Social Invitations Plugin
Linkedin App

4. Live - top

Live, Msn or Hotmail do not require any other step. Just activate it on the settings page :

5. Facebook - top

To enable authentication with this provider and to register a new Facebook API Application, carefully follow the steps :

  1. Go to https://developers.facebook.com/apps and create a new application.
  2. Fill out App Name, App Namespace and click continue
  3. Enter your domain in "App Domains" field. eg: example.com
  4. Desactivate Sandbox Mode
  5. Check "Website with Facebook Login" and enter your website url
  6. Click on Save Changes and copy App ID and App Secret into Wordpress Social Invitations
facebook App

facebook App

6. Twitter - top

To enable authentication with this provider and to register a new Twitter API Application, carefully follow the steps :

  1. Go to https://dev.twitter.com/apps and create a new application.
  2. Fill out any required fields such as the application name and description , website, etc.
  3. On "Callback URL" enter your website url followed by /wp-content/plugins/wordpress-social-invitations/hybridauth/?hauth.done=twitter. If your site is www.example.com , you need to enter http://www.example.com/wp-content/plugins/wordpress-social-invitations/hybridauth/?hauth.done=twitter and that should be shown in the Redirect URI field
  4. Accept terms and create the application
  5. Go the the settings tab and change your application type to "Read, Write and Access direct messages"
  6. Copy Consumer Key and Consumer Secret into Wordpress Social Invitations
twitter App

twitter App

7. Foursquare - top

To enable authentication with this provider and to register a new Foursquare API Application, carefully follow the steps :

  1. Go to https://es.foursquare.com/developers/register and create a new application.
  2. Fill out your "Welcome page" with your website url
  3. On "Redirect URI" enter your website url followed by /wp-content/plugins/wordpress-social-invitations/hybridauth/?hauth.done=foursquare. If your site is www.example.com , you need to enter http://www.example.com/wp-content/plugins/wordpress-social-invitations/hybridauth/?hauth.done=foursquare and that should be shown in the Redirect URI field
  4. Save the changes
  5. Copy Client ID and Client Secret into Wordpress Social Invitations
Foursquare App

C) Shortcodes - top

You can display Wordpress social Invitation in any page by using shortcodes:

Basic Shortcode

[wsi title="Invite your friends!"]

D) PHP function - top

It works the same way as shortcodes. Just call it like:

<?php WP_Social_Invitations::widget('Invite some friends!!') ?>

E) Hooks - top

Wordpress Social invitations hooks into Buddypress activation page and Invite Anyone plugin.

Be aware that with Invite Anyone plugin not all the providers will work. Only the ones that return user emails (Yahoo, Live, Gmail)

You can also redirect users to a specific page after they send the invitations

F) Translation - top

With Poedit you can edit wsi.po that is located in the root of the plugin. Once translated save it into the languages folder and rename both .po and .mo to the translated language. For example if you translated the plugin into spanish, save it as es_ES.mo and es_ES.po

G) Sources and Credits - top

Once again, thank you so much for purchasing this plugin. As I said at the beginning, I'd be glad to help you if you have any questions relating to this plugin. No guarantees, but I'll do my best to assist. If you have a more general question relating to the plugins on CodeCanyon, you might consider visiting the forums and asking your question in the "Item Discussion" section.

Timersys

Go To Table of Contents