Twitter Integration Plugin

From Smart Job Board help

Smart Job Board Help > Twitter Integration Plugin
Jump to: navigation, search

Contents

This plug-in is used to export postings (jobs and/or resumes) from your job board site to Twitter web-site (twitter.com).
Exporting can be done automatically according to the task scheduler settings or manually via Admin Panel.

 Note: In order to export listings to Twitter you need to have an account on twitter.com. 
 The exported jobs/resumes will be posted on Twitter on behalf of this account. 

To set the Twitter Integration Plugin go to Admin Panel -> System Configuration -> Plugins. Uhe checkbox in the "Status" column to activate and deactivate the plugin.

          Twitter settings.png


Click on the "Settings" link opposite the TwitterIntegrationPlugin, you will see the following page opened:


          Twitter settings page.png


Creating a New Feed

Click on the "Add New Feed" link to create the Feed to export and post listings to Twitter.

On the top of the opened page you will see the "Twitter Loging" section. You need to enter the username of an account you registered on twitter.com


             Twitter username.png


Further you see two fields "Twitter API Consumer Key" and "Twitter API Consumer Secret":
            Api consumer key secret.png


To get the data to be pasted to these fields, please follow the instruction given
here.



Under this section there is the "Filter Criteria" section where you need to specify the criteria for the listings that should be exported to Twitter:

          Twitter filter criteria.png


And the bottom section is the "Posting Settings", where you need to set the parameters for posting to Twitter:

          Twitter posting settings.png


Update every ...listings - once this number of listings (e.g. 5) meeting the specified filter criteria found in the system - they will be posted to Twitter.
If the number of listings meeting the criteria is less then 5, e.g. 3 - then they will not be posted to Twitter, untill there will be 5 listings;

Hash tags - A hash tag is a way for people to search for tweets that have a common topic;

Twitter post template - the template of the posting on Twitter, by deafult it is {$user.CompanyName}: {$listing.Title} ({$listing.City}, {$listing.State})
If you want any of the listed at the bottom of the page fields to be included in the twitter post you need to copy its code and paste to the "Twitter Post Template" field.

Then press the "Save" button to complete. The newly created Feed will appear in the table on the "TwitterIntegrationPlugin Settings" page.


Register a New App

To get the Twitter API Consumer Key and Twitter API Consumer Secret, you need to do the following:

1) Go to http://dev.twitter.com/

2) Click on the "Register an app" link located in the middle:

            Register an app.png

3) You wil see Register an Application page opened. Please fill in the fields with the following data:

          Application name.png - you may enter your twitter username or another desired name;

           Description.png- enter any desired description, it should be more than 10 characters;

          Application website.png - enter your site full URL, e.g. http://www.site.com

           Application type.png                        - select "Browser";

           Callback url.png  - enter again your site full URL, e.g. http://www.site.com

           Default access type.png       - select "Read & Write.


 Note: only required fields are listed above. The fields "Organization" and "Application Icon" are optional. 

To complete registering a new app, press the "Register Application" button at the bottom of the page.

Then you will be redirected to the Settings page. On that page you need to find the Consumer Key and Consumer Secret:

Consumer key secret.png

You need to copy them, go back to your Feed (Admin Panel >> System Configuration >> Plugins >> TwitterIntegrationPlugin >> your Feed)
And paste the Consumer Key and Consumer Secret you copied to the appropriate fields.


Allow Application to Post to Twitter

Once you created a new feed you you will be automatically redirected to Twitter to permit accessing and updating your data on Twitter.

Note: Permission to access twitter account can be also granted manually, for that use the "Grant Permission" link located opposite the feed you created.

Grant permission.png

You will see the followin screen:

           Twitter allow connection.png

You just need to enter your username or Email and password of your twitter account. And then press the "Allow" button.
That's it. Then you will be automatically redirected back to your Admin Panel:

           Twitter redirecting back.png


And there you will see the message that Twitter account was updated successfully.

         Twitter updated successfully.png




Posting to Twitter

Posting to Twitter can be done either automatically or manually.

  • Posting automatically

To make the system to post to Twitter automatically you need to configure CRON to run the script given to you on the top of the "TwitterIntegrationPlugin Settings" page.

          Twitter settings note.png

 Note: Instructions for configuring CRON you can find on the Task Scheduler page of your Admin Panel
 (Admin Panel -> System Configuratoin -> Task Scheduler)


  • Running Manually

You can also run the script to post to Twitter manually at any time. For that you need to press the "Run" button:

          Run manually.png

The system will check if there are any listings meeting the criteria you specified in the Filter Criteia.
If there are any (e.g. 3) you will see the following message:

          3 jobs found.png


Then you need to press the "Ok" button in in order to post these Jobs to Twitter right now.
The system will immediatelly post the job and display the following message:

          3 jobs posted.png


That's it! You may close this dialog box.

If then you go to twitter.com and sign in you will see the posted jobs:

          Twitter home.png





Personal tools

User Manual for the latest version

Toolbox