Skip to end of metadata
Go to start of metadata

IMPORTANT:

Twitter plug-in is abolished in SmartJobBoard ver. 4.2 and transfered to the main functionality of the software. It is not considered as plugin anymore but it is included in the software.

You can set up Twitter settings in the Admin Panel.

If you use version lower than 4.2 please refer to following article:

 

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.

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

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

Further you see two fields "Twitter API Consumer Key" and "Twitter API Consumer Secret":

To get the data to be pasted to these fields, please follow the instruction given in Register an App section.

 

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:

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

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;

Posting Limit ... per day - Here you can limit the number of postings to be posted on Twitter per day because Twitter has certain limitations on posting that can be chekced here: https://support.twitter.com/articles/15364-about-twitter-limits-update-api-dm-and-following

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:

           

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

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

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

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

                                   - select "Browser";

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

                  - 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:

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.


You will see the followin screen:

You just need to click 'Authorize app'.
That's it. Then you will be automatically redirected back to your Admin Panel:


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

        

 

 

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.

         

 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:

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:

 

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:

 

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:

         

 

  • No labels