Elgg social contact importer and inviter is a Elgg contacts plugin will allow users to import their Yahoo, Gmail and Hotmail contacts to the system and sent and invitation to them. This plugin using Oauth API so the users credentials are safe and authenticating at their provider site (Yahoo,Google and Hotmail).
Elgg plugin installation is pretty simple and same like any other Elgg plugin. download the Zip file and Extract to the mod directory. Then simply go the admin panel plugin list and activate the WWM Contact Importer.
The plugin front end can be visit with following URL. www.yourdomain.com/contactimporter This plugin required a login to Elgg site so make sure you already logged in or type the URL after the login.
Lets check the features of WWM Social Contact Importer plugin for elgg platform.
- You can import Yahoo Contacts.
- You can import Gmail Contacts.
- You can import Hotmail Contacts.
- Invite Message and email options enabled.
- Contacts include/Exclude options.
- Using Oauth API for improved security.
- Once contact imported data saved on DB until they sent invitation.
- 1 Invitation for all 3 Operators contacts.
Now check how to configure the plugin and its compatibility this plugin is compatable for Elgg Version 1.8+ .Gmail Account Configuration
I already mentioned that the plugin using Oauth method for improved security so its important to set up the web based app for your Google account. First go to Google Project console.
Step 1 :
- Create a Project for your Elgg site to import contacts.
- Under API & Auth menu click credentials and create new one.(Note the Client Id and Secret Key).
- Under API menu make sure Contact API is ON.
- Make sure the Return URI is set with www.yourdomain.com/mod/wwm_contactinviter/actions/gmailcallback.php.
- Setup your APP Consent Screen (Optional for Good looking to the users).
Step 2 :
- Go to your elgg admin panel settings menu -> WWM Contact Inviter.
- Set the Client ID and Secret Key on the Plugin Options.
First you have to create an APP with Yahoo for enabling contact API of yahoo. Just follow the procedures below.
click here to create an APP on yahoo. Once you success fully signup with Yahoo APP. you will get APP Id and APP secret Key not it down. make sure you are set the return uri correctly.
- Create New Yahoo Project verify your domain.
- Set the Return URI (call back url) as www.yourdomain.com/mod/wwm_contactinviter/actions/yahoocallback.php.
- Set the APP scope with Contacts read/write and messenger.
- Save the details.
Set the APP Id and Secret key on your Elgg WWM Contact Inviter Option section.
Hotmail Account Configuration
For setting up the Hotmail account for your Elgg site you have to follow the instructions.
- Create an APP with Hotmail account here.
- Set up the APP permission.
- Make sure redirect URI set correctly as www.yourdomain.com/mod/wwm_contactinviter/actions/msncallback.php.
- Step 3 is very important for Hotmail account do not forget it.
- Note down the Client Id and Secret Key for your plugin option panel.
Now you are successfully configured all the accounts for WWM Social Contact importer. check your plugin options will be look like below.
This plugin will available on EPD (Elgg Plugin directory) Feel free to to comment suggestions and improvements.
Download the plugin and install on your site then visit the site like. www.yourdomain.com/contactimporter