Site Widgets
Would you like to display our latest jobs on your site?
There are two types of widgets you can apply:
- Get Jobs Widget: This widget is used to retrive jobs based on their category, posting duration, and job-type. You can also configure on how many jobs you want to display and order them on the basis of their publication date or even show randomly.
List of parameters to be used in this implementation:- action: "getJobs" - all jobs
- type: "0" - all / "fulltime" / "parttime" / "freelance"
- category: "0" - all / "programmers" / "designers" / "administrators" / "managers" / "testers" / "editors"
- count: number of job ads to display
- random: "1" - display randomly / "0" - display ordered by publish date (newest on top)
- days_behind: get only jobs posted in the past X days (type "0" if you don't want to limit this)
- response: "js" - returns jobs as JavaScript code / "json" - returns only a JSON string / "xml" - returns an XML
Some sample codes using this:- The following code displays last 5 jobs posted in the past 10 days in administrator category as fulltime and ordered by publishing date(newest on top):
<script src="http://www.philanthropist.org/jobs/api/api.php?action=getJobs
&type=fulltime&category=administrators&count=5&random=0&days_behind=10&response=js"
type="text/javascript"></script>
<script type="text/javascript">showJobs('jobber-container', 'jobber-list');</script> - The following code displays latest 5 jobs from all categories of all types posted in last 7 days in random order:
<script src="http://www.philanthropist.org/jobs/api/api.php?action=getJobs
&type=0&category=0&count=5&random=1&days_behind=7&response=js" type="text/javascript"></script>
<script type="text/javascript">showJobs('jobber-container', 'jobber-list');</script>
- Get Jobs by Company Widget: This widget is used to retrive jobs based on their company and their count.
List of parameters to be used in this implementation:- action: "getJobsByCompany" - a single company's jobs
- count: number of job ads to display
- response: "js" - returns jobs as JavaScript code / "json" - returns only a JSON string / "xml" - returns an XML
A code for this get latest 10 jobs published by Google:<script src="http://www.philanthropist.org/jobs/api/api.php?action=getJobsByCompany
&company=google&count=10&response=js" type="text/javascript"></script>
<script type="text/javascript">showJobs('jobber-container', 'jobber-list');</script>
CSS Styling
You can use some custom css to style the display the job list. Here is a sample code:ul.jobber-list {
list-style-type: none;
margin: 0;
padding: 0;
}
ul.jobber-list li {
margin-bottom: 5px;
}
Note:
- You can notice that there are two script codes for each implementation, the script which points to the api.php class can be included anywhere in your site but the second code should appear at the place where you want to display the jobs.
- There is a live demo script using the api code. Test it now. You can view its source in browser to check its implmentation. You can edit it live to test it before implementing the code live elsewhere.
