Want to post new jobs to popular micro-blogging service Twitter? Of course you do. Follow the tutorial below to make your Jobberbase site almost as cool as AllDevJobs.com.

To avoid conflicting with newer versions of Jobberbase, I am writing this tutorial for any version so it should always work. As always, make sure you back up your site before you proceed with the following changes.

Step 1: Create a Twitter Account

This may seem obvious, but yes, you need to create a new account. Create Account »

Step 2: Modify config.php

In the root directory of your Jobberbase installation, you have a ‘config.php’ file. In that file you will want to add your Twitter account information. I added mine at line 41. The bolded text indicates the places you need to add your account info.

/* Twitter username & password */
define('TWITTER_ENABLED',1);
define('TWITTER_USERNAME','username_goes_here');
define('TWITTER_PASSWORD','password_goes_here');

After that’s done, you also need to add a reference to the Twitter function you’ll be creating in Step 4. Around line 87, you should see the following:

// Function and classes includes
require_once '_includes/function.validate_email.php';
require_once '_includes/function.redirect_to.php';
require_once '_includes/function.printr.php';
require_once '_includes/function.escape.php';
require_once '_includes/functions.php';
require_once '_includes/class.phpmailer.php';
require_once '_includes/class.Postman.php';
...

You need to add require_once '_includes/function.Twitter.php'; to this list. I added it just after require_once '_includes/functions.php';.

When done, it should look like this:

// Function and classes includes
require_once '_includes/function.validate_email.php';
require_once '_includes/function.redirect_to.php';
require_once '_includes/function.printr.php';
require_once '_includes/function.escape.php';
require_once '_includes/function.Twitter.php';
require_once '_includes/functions.php';
require_once '_includes/class.phpmailer.php';
require_once '_includes/class.Postman.php';
require_once '_includes/class.Textile.php';
require_once '_includes/class.Sanitizer.php';
require_once '_includes/class.Db.php';
require_once '_includes/class.Job.php';
require_once '_includes/class.JobRequest.php';
require_once '_includes/class.Paginator.php';
require_once '_includes/class.Feed.php';
require_once '_includes/class.SpamReport.php';
require_once '_includes/class.Api.php';
require_once '_includes/class.JobApplication.php';
require_once '_includes/class.SearchKeywords.php';
require_once '_includes/smarty/libs/Smarty.class.php';

Step 3: Edit file ‘_includes/class.Job.php’

You will shortly be creating a new Twitter function that will post the job listings for you, however, you need to find the right place to call that function, which would be immediately after the job listing is activated, not necessarily when it’s been posted, because you don’t want people just posting anything to Twitter before you’ve reviewed it.

Around line 873, you’ll need to replace the entire public function Publish() with the following code:

	// Publishes a newly created job post (is_temp => 0)
	public function Publish()
	{
		global $db;
		if ($this->CheckPosterEmail())
		{
			$sql = 'UPDATE jobs SET is_temp = 0, is_active = 1 WHERE id = ' . $this->mId;
			$db->query($sql);

			$sql = 'SELECT type_id, id, title, company FROM jobs WHERE id = ' . $this->mId;
			$result = $db->query($sql);
			$row = $result->fetch_assoc();

		  $formattedMessage = $row['title'] . " at " .$row['company'] . " " . BASE_URL . "job/" .$row['id'] . "/";
		  Tweet($formattedMessage);

		}
		else
		{
			$sql = 'UPDATE jobs SET is_temp = 0, is_active = 0 WHERE id = ' . $this->mId;
			$db->query($sql);
		}

	}

Step 4: Create file ‘_includes/function.Twitter.php’

In your main includes directory, you need to create a new file for the script to post Twitter messages. You will need to have cURL enabled on your server for this to work.

Inside the new file, add this:

<?php
/**
 * Twitter post API
 */

function Tweet($msg){
	if(TWITTER_ENABLED==1){

		$username = TWITTER_USERNAME;
		$password = TWITTER_PASSWORD; 

		$message = $msg;

		$url = 'http://twitter.com/statuses/update.xml';
		// Alternative JSON version
		// $url = 'http://twitter.com/statuses/update.json';

		$curl_handle = curl_init();
		curl_setopt($curl_handle, CURLOPT_URL, "$url");
		curl_setopt($curl_handle, CURLOPT_CONNECTTIMEOUT, 2);
		curl_setopt($curl_handle, CURLOPT_RETURNTRANSFER, 1);
		curl_setopt($curl_handle, CURLOPT_POST, 1);
		curl_setopt($curl_handle, CURLOPT_POSTFIELDS, "status=$message");
		curl_setopt($curl_handle, CURLOPT_USERPWD, "$username:$password");
		$buffer = curl_exec($curl_handle);
		curl_close($curl_handle);
		// check for success or failure
		if (empty($buffer)) {
				echo 'Post failed. Please add listing manually.';
		} else {
				echo 'Success';
		}
	}
}

?>

That’s it. Upload your files and you’re ready to post to Twitter. Please let me know if you have any difficulties with this tutorial and I will update it accordingly.

I recently released a developer job board built with Jobberbase, an open-source job board software written in PHP/MySQL. While I can’t recommend it for a large job networking site, it is a great piece of software for adding a simple job board to your existing website. I thought I would give a quick rundown on its features, installation process, and some customization tips to get you started.

Features

Below, I’ve listed some of the features of Jobberbase:

• Post jobs without an account.
• Search for jobs (ajax).
• Apply for jobs.
• Administer jobs via admin panel (edit/delete/activate/deactivate).
• RSS feeds.
• Job widget.

Installation

These are the installation instructions from the Jobberbase readme.txt file:

1. Make sure you have PHP 5+ and MySQL 4.1+ installed. Also, Apache module mod_rewrite should be enabled.
2. Create a new database and import __db/jobberbase.sql into it.
3. Open config.php and update the following constants so they suit your environment:
   - DB_HOST, DB_USER, DB_PASS, DB_NAME, NOTIFY_EMAIL, ADMIN_EMAIL, SITE_NAME
4. Following directories need write access:
   /uploads (uploaded resumes are temporary stored here)
   /_templates/_cache (smarty cache)
5. If your host doesn’t offer the mysqli PHP extension (find out from phpinfo()),
   you can use a mysql wrapper instead.Open config.php and just replace <require_once ‘_includes/class.Db.php’> with
   <require_once ‘_includes/class.Db.MySql.php’>.
6. That’s it, open a browser and type in the URL (e.g. http://localhost/jobberbase/).
7. The admin panel is available at http://localhost/admin/ with the default username “admin” and password “admin”.

Customizing It

After following the installation directions on the Jobberbase website, you should customize your new job site. A lot of Jobberbase sites end up looking exactly the same as the original, simply because they change the logo and nothing else. You don’t want to do that.

Jobberbase uses Smarty Templates

If you are not familiar with Smarty, you can read up on it here. Smarty templates are great because they separate the presentation layer from the application layer, which is always a good thing. However, you still have the ability to run your own code within the Smarty templates, which can sometimes be necessary as well. Smarty.net explains the reasoning well here:

One of Smartys primary design goals is to facilitate the separation of application code from presentation. Typically, the application code contains the business logic of your application, written and maintained in PHP code. This code is maintained by programmers. The presentation is the way your content is presented to the end user, which is written and maintained in template files. The templates are maintained by template designers.

After you’ve installed Jobberbase, you should have the following folder structure (minus the ‘phpmyadmin’ folder):

You are going to want to dive into the ‘css’ and ‘_templates’ folder to modify your site design. No need to touch anything else for now. The ‘css’ folder is pretty self-explanatory. Edit the CSS there. The ‘_templates’ folder has a lot more to look at:

These are your Smarty templates. As you can see, they are labeled quite well and you should be able to make the changes you need by editing these files. However, there are some things you should know about Smarty templates. For example, they don’t allow you to run any JavaScript unless you wrap the code in {literal} tags:

{literal}
  <script type="text/javascript">
  var smarty = "This code can now be run.";
  alert(smarty);
  </script>
{/literal}

When I first started using Smarty, not knowing the rules of the templates was enough to make me slam my face into my desk. But once you know it, it’s no problem. You can read more about Smarty here.

The main templates you may want to modify are of course the ‘header.tpl’ and ‘footer.tpl’ files but also take a look at the ‘sidebar.tpl’ file as well. This is a great place to add some customizations. I added a link to a twitter account that is set up to automatically post jobs every time one is approved.

Questions? Comments? Let me know in the comments below.