Skip to content

Commit

Permalink
Merge branch 'release/v3.0.4'
Browse files Browse the repository at this point in the history
  • Loading branch information
@wpmark
wpmark committed Jun 20, 2019
2 parents 96c548b + bf0c96e commit 8667863
Show file tree
Hide file tree
Showing 8 changed files with 162 additions and 15 deletions.
10 changes: 7 additions & 3 deletions inc/admin-menus/settings-page.php
View file
Original file line number Diff line number Diff line change
Expand Up @@ -133,9 +133,6 @@ function wpbb_settings_page_output() {

<?php

// Fires after the settings output table is closed.
do_action( 'wpbb_after_settings_output', $plugin_page );

} // End if().

?>
Expand All @@ -144,6 +141,13 @@ function wpbb_settings_page_output() {
<input type="submit" name="wpbb_settings_submit" id="submit" class="button-primary" value="<?php echo esc_attr( 'Save Changes', 'wpbroadbean' ); ?>" />
</p>

<?php

// Fires after the settings output table is closed.
do_action( 'wpbb_after_settings_output', $plugin_page );

?>

</form>

<?php
Expand Down
77 changes: 77 additions & 0 deletions inc/job-fields/job-fields-default.php
View file
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,13 @@ function wpbb_add_default_job_fields( $fields ) {
'show_on_frontend' => false,
'cols' => 12,
'order' => 5,
'jobfeed_notes' => array(
'data_type' => 'string',
'input_type' => 'textarea',
'default_value' => '',
'example_value' => __( 'This is the short description', 'wpbroadbean' ),
'notes' => __( 'A short description of the job. This should not contain any HTML, just text.', 'wpbroadbean' ),
),
);

/* add the job reference field */
Expand All @@ -71,6 +78,13 @@ function wpbb_add_default_job_fields( $fields ) {
'show_on_frontend' => true,
'cols' => 4,
'order' => 10,
'jobfeed_notes' => array(
'data_type' => 'string',
'input_type' => 'text',
'default_value' => '',
'example_value' => 'REF-1234',
'notes' => __( 'This is a reference for each job and MUST BE UNIQUE to each job. It should not contain any special characters, just lower and upper case letters, dashes and numbers please.', 'wpbroadbean' ),
),
);

/* add the application tracking email field */
Expand All @@ -83,6 +97,13 @@ function wpbb_add_default_job_fields( $fields ) {
'show_on_frontend' => false,
'cols' => 4,
'order' => 20,
'jobfeed_notes' => array(
'data_type' => 'text',
'input_type' => 'email',
'default_value' => '',
'example_value' => 'bob.12345.123@smith.aplitrak.com',
'notes' => __( 'This is the unique applicant tracking address for this job and applications made to this job are delivered to this address.', 'wpbroadbean' ),
),
);

/* add the application tracking url field */
Expand All @@ -95,6 +116,13 @@ function wpbb_add_default_job_fields( $fields ) {
'show_on_frontend' => false,
'cols' => 4,
'order' => 30,
'jobfeed_notes' => array(
'data_type' => 'text',
'input_type' => 'text',
'default_value' => '',
'example_value' => 'https://apply.url',
'notes' => __( 'If the client is supporting application URLs rather than using the tracking email address, this is the URL where candidates can apply on a Broadbean hosted application form', 'wpbroadbean' ),
),
);

/* add the salary display field */
Expand All @@ -107,6 +135,13 @@ function wpbb_add_default_job_fields( $fields ) {
'show_on_frontend' => true,
'cols' => 3,
'order' => 40,
'jobfeed_notes' => array(
'data_type' => 'string',
'input_type' => 'text',
'default_value' => '',
'example_value' => __( '£30,000 per year with benefits including travel and conference budget', 'wpbroadbean' ),
'notes' => __( 'A string explaining any salary and benefits the candidate may receive.', 'wpbroadbean' ),
),
);

/* add the salary field */
Expand All @@ -119,6 +154,13 @@ function wpbb_add_default_job_fields( $fields ) {
'show_on_frontend' => false,
'cols' => 2,
'order' => 50,
'jobfeed_notes' => array(
'data_type' => 'integer',
'input_type' => 'number',
'default_value' => '',
'example_value' => '30000',
'notes' => __( 'An integer value to represent the salary on offer for this job. If a site uses salary search, this value is used to determin the salary for the job.', 'wpbroadbean' ),
),
);

/* add the salary from field */
Expand All @@ -131,6 +173,13 @@ function wpbb_add_default_job_fields( $fields ) {
'show_on_frontend' => true,
'cols' => 2,
'order' => 60,
'jobfeed_notes' => array(
'data_type' => 'integer',
'input_type' => 'number',
'default_value' => '',
'example_value' => '26000',
'notes' => __( 'An integer value to represent the low salary range value for this job.', 'wpbroadbean' ),
),
);

/* add the salary from field */
Expand All @@ -143,6 +192,13 @@ function wpbb_add_default_job_fields( $fields ) {
'show_on_frontend' => true,
'cols' => 2,
'order' => 70,
'jobfeed_notes' => array(
'data_type' => 'integer',
'input_type' => 'number',
'default_value' => '',
'example_value' => '30000',
'notes' => __( 'An integer value to represent the high salary range value for this job.', 'wpbroadbean' ),
),
);

/* add the job reference field */
Expand All @@ -155,6 +211,13 @@ function wpbb_add_default_job_fields( $fields ) {
'show_on_frontend' => false,
'cols' => 3,
'order' => 80,
'jobfeed_notes' => array(
'data_type' => 'string',
'input_type' => 'select',
'default_value' => 'GBP',
'example_value' => 'USD',
'notes' => __( 'Support for USD, GBP and EUR are provided. A select input for these options would be good.', 'wpbroadbean' ),
),
);

/* add the job reference field */
Expand All @@ -167,6 +230,13 @@ function wpbb_add_default_job_fields( $fields ) {
'show_on_frontend' => false,
'cols' => 6,
'order' => 90,
'jobfeed_notes' => array(
'data_type' => 'integer',
'input_type' => 'number',
'default_value' => '28',
'example_value' => '16',
'notes' => __( 'The number of days the job should be advertised on ths site for.', 'wpbroadbean' ),
),
);

// add the application tracking url field.
Expand All @@ -179,6 +249,13 @@ function wpbb_add_default_job_fields( $fields ) {
'show_on_frontend' => false,
'cols' => 6,
'order' => 100,
'jobfeed_notes' => array(
'data_type' => 'text',
'input_type' => 'email',
'default_value' => '',
'example_value' => 'john@company.com',
'notes' => __( 'The email address of the consultant posting the job. Likely this can be pulled from their Broadbean/Adcourier account and set automatically without having to manually enter it.', 'wpbroadbean' ),
),
);

/* return the modified fields array */
Expand Down
1 change: 1 addition & 0 deletions inc/post-types.php
View file
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,7 @@ function wpbb_register_job_post_type() {
'title',
'editor',
'excerpt',
'author',
),
'query_var' => true,
'rewrite' => array(
Expand Down
28 changes: 28 additions & 0 deletions inc/taxonomies.php
View file
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,13 @@ function wpbb_register_default_taxonomies( $taxonomies ) {
'hierarchical' => true,
'show_admin_column' => true,
'show_on_frontend' => true,
'jobfeed_notes' => array(
'data_type' => 'string',
'input_type' => 'text',
'default_value' => '',
'example_value' => 'Accounting|Computing',
'notes' => __( 'A pipe seperated string of job industries.', 'wpbroadbean' ),
),
);

// add the job location taxonomy.
Expand All @@ -46,6 +53,13 @@ function wpbb_register_default_taxonomies( $taxonomies ) {
'hierarchical' => true,
'show_admin_column' => true,
'show_on_frontend' => true,
'jobfeed_notes' => array(
'data_type' => 'string',
'input_type' => 'text',
'default_value' => '',
'example_value' => 'London|Manchester',
'notes' => __( 'A pipe seperated string of job locations. It is better if this plugin has a defined list of locations to support, rather than using the standard Broadbean locations.', 'wpbroadbean' ),
),
);

// add the job type taxonomy.
Expand All @@ -59,6 +73,13 @@ function wpbb_register_default_taxonomies( $taxonomies ) {
'hierarchical' => true,
'show_admin_column' => true,
'show_on_frontend' => true,
'jobfeed_notes' => array(
'data_type' => 'string',
'input_type' => 'text',
'default_value' => '',
'example_value' => 'Permanent|Temporary|Contract',
'notes' => __( 'A pipe seperated string of job types.', 'wpbroadbean' ),
),
);

// add the job skills taxonomy.
Expand All @@ -72,6 +93,13 @@ function wpbb_register_default_taxonomies( $taxonomies ) {
'hierarchical' => false,
'show_admin_column' => true,
'show_on_frontend' => true,
'jobfeed_notes' => array(
'data_type' => 'string',
'input_type' => 'text',
'default_value' => '',
'example_value' => 'PHP|Javascript',
'notes' => __( 'A pipe seperated string of job skills.', 'wpbroadbean' ),
),
);

// return the modified taxonomies.
Expand Down
25 changes: 18 additions & 7 deletions readme.txt
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,23 +4,28 @@ Tags: jobs, recruitment
Requires at least: 5.1
Requires PHP: 5.6
Tested up to: 5.2
Stable tag: 3.0.3
Stable tag: 3.0.4
Donate link: https://store.highrise.digital/downloads/wpbroadbean-support-docs/
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

WP Broadbean is a plugin which allows jobs added to Broadbean to show in your WordPress site.

== Description ==

[WP Broadbean](https://highrise.digital/products/wpbroadbean-wordpress-plugin/) is a plugin designed to work alongside the [Broadbean job posting and distribution](https://www.broadbean.com/uk/products/features/job-posting-distribution/) system allowing jobs written in Broadbean to show in your WordPress site. The plugin adds custom post types and taxonomies to allow you to add jobs. More importantly it allows your site to accept feed data sent by Broadbean to create jobs on your site.
[WP Broadbean](https://highrise.digital/products/wpbroadbean-wordpress-plugin/) is a WordPress plugin designed to work alongside the [Broadbean job posting and distribution](https://www.broadbean.com/uk/products/features/job-posting-distribution/) system allowing jobs written in Broadbean to show in your WordPress site.

The plugin requires some collaboration with the Broadbean integrations team. This is because they need to add your WordPress site as a posting destination, and to build a "feed" to your WordPress sites endpoint, provided by this plugin, in the form of XML data.
The plugin adds custom post types and taxonomies to allow you to add jobs. More importantly it allows your site to accept feed data sent by Broadbean to create jobs on your site.

If you are struggling with any aspects of a site integration, we offer a complete integration service which you can take advantage of. Find out more about our this on our [WP Broadbean information page](https://highrise.digital/products/wpbroadbean-wordpress-plugin/).
The plugin requires some collaboration with the Broadbean integrations team. This is because they need to add your WordPress site as a posting destination, and to build a "feed" to your WordPress sites endpoint, provided by this plugin, in the form of XML data. They are likely to charge you for this service.

We also have some add-ons for this plugin which you can find out more about on the [WP Broadbean plugin page](https://highrise.digital/products/wpbroadbean-wordpress-plugin/).
## Support and documentation

This plugin is provided as is, and community support is available via the support forums here. If you are looking for expert help in getting your site setup to post jobs from Broadbean, Highrise Digital offer a couple of solutions. We can provide [bespoke consultancy](https://highrise.digital/contact/), support and development however we also have a [support add-on package](https://store.highrise.digital/downloads/wpbroadbean-support-docs/). This add-on package provides all the information Broadbean need to build your job feed, access to our extensive plugin documentation resource and limited email support from the team at Highrise Digital.

Highrise Digital also offer a number of [WordPress Broadbean integration services](https://highrise.digital/broadbean-wordpress-integrations/) as well as services to [integrate LogicMelon with WordPress](https://highrise.digital/services/integrate-logicmelon-wordpress/).
## WP Broadbean add-ons

We also have some add-ons for this plugin which you can find out more about on the [WP Broadbean plugin page](https://highrise.digital/products/wpbroadbean-wordpress-plugin/).

For the sake of clarity, the WP Broadbean plugin is not affiliated in any way with Broadbean Technology Limited.

Expand All @@ -38,14 +43,20 @@ To install the plugin:

== Frequently Asked Questions ==

It is a new version, therefore we don't have any FAQs just yet. Feel free to [submit an issue](https://github.com/highrisedigital/wpbroadbean/issues) over on the Github repository. We can then turn the popular questions into FAQs on the Wiki.
Frequently asked questions are available [here](https://store.highrise.digital/docs/wp-broadbean/).

== Screenshots ==

1. The job edit screen in WordPress

== Changelog ==

= 3.0.4 =
* Added job feed notes to the default job fields and taxonomies.
* Added information to the settings page and the new support add-on.
* Move the after settings hooks so it is actually after all the settings on the settings page.
* Allows the job author to be set in WordPress based on the `consultant_email` field.

= 3.0.3 =
* Correct check for an empty value for the posted XML before proceeding with the inbox template. Prevents warnings when the posted data is incorrect and gives the appropriate error message.
* Fix a call to and undefined function in the post title filter functions. Thanks to @bencorke for contributing this fix and finding the bug.
Expand Down
25 changes: 25 additions & 0 deletions templates/inbox.php
View file
Original file line number Diff line number Diff line change
Expand Up @@ -74,6 +74,31 @@

}

// set a default author ID to zero.
$author = 0;

// do we have a consultant email in the feed.
if ( ! empty( $xml->consultant_email ) ) {

// check if consultant email is a valid email.
if ( is_email( $xml->consultant_email ) ) {

// check for a WordPress user with this email address.
$user = get_user_by( 'email', $xml->consultant_email );

// if we have a user returned.
if ( false !== $user ) {

// set the author as the users user id.
$author = $user->ID;

}
}
}

// add the author to the insert post args.
$insert_job_args['post_author'] = absint( $author );

/**
* Lets now insert the post for this job.
* Uses the standard wp_insert_post function.
Expand Down
7 changes: 4 additions & 3 deletions views/settings-ctas.php
View file
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@
<label for="mce-EMAIL">Email Address <span class="asterisk">*</span></label>
<input type="email" value="" name="EMAIL" class="required email" id="mce-EMAIL" placeholder="<?php echo esc_attr( get_option( 'admin_email' ) ); ?>">
</div>
<p><a href="https://us17.campaign-archive.com/home/?u=8f84734f114d7816de2addb0d&id=eb5dafa0ef"><?php esc_html_e( 'View previous security emails sent to users', 'wpbroadbean' ); ?></a></p>
<p><a href="https://us17.campaign-archive.com/home/?u=8f84734f114d7816de2addb0d&id=eb5dafa0ef"><?php esc_html_e( 'View previous emails sent to users', 'wpbroadbean' ); ?></a></p>
<div id="mce-responses" class="clear">
<div class="response" id="mce-error-response" style="display:none"></div>
<div class="response" id="mce-success-response" style="display:none"></div>
Expand All @@ -62,8 +62,9 @@

<h2 class="hndle ui-sortable-handle wpbb-postbox-title"><?php esc_html_e( 'Need some help?', 'wpbroadbean' ); ?></h2>
<div class="inside">
<p><?php esc_html_e( 'If you are finding things a little tricky to setup, fear not. We are experienced at integrating WordPress sites with Broadbean and provide a fully managed integration service.', 'wpbroadbean' ); ?></p>
<a class="button-primary" href="https://highrise.digital/services/integrate-broadbean-wordpress/"><?php esc_html_e( 'Find out more', 'wpbroadbean' ); ?></a>
<p><?php esc_html_e( 'If you are finding things a little tricky to setup, fear not. We are experienced at integrating WordPress sites with Broadbean and provide a fully managed integration service. Or you can purchase our support add-on plugin, which provides access to all support documentation and adds a readme to your site which Broadbean can use to help build your feed.', 'wpbroadbean' ); ?></p>
<a class="button-primary" href="https://highrise.digital/services/integrate-broadbean-wordpress/"><?php esc_html_e( 'Get custom support', 'wpbroadbean' ); ?></a>
<a class="button-primary" href="https://store.highrise.digital/downloads/wpbroadbean-support-docs/"><?php esc_html_e( 'Buy our support add-on', 'wpbroadbean' ); ?></a>
</div>

</div>
Expand Down
4 changes: 2 additions & 2 deletions wpbroadbean.php
View file
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
Plugin Name: WP Broadbean
Plugin URI: https://highrise.digital/products/wpbroadbean-wordpress-plugin/
Description: A plugin which integrates <a href="https://www.broadbean.com/uk/products/features/job-posting-distribution/">Broadbean job posting and distribution</a> with WordPress. It allows jobs written in Broadbean to be distributed to a WordPress site and have applications made to those jobs in WordPress delivered back to Broadbean.
Version: 3.0.2
Version: 3.0.4
Author: Highrise Digital
Author URI: https://highrise.digital
License: GPLv3 or later
Expand Down Expand Up @@ -31,7 +31,7 @@
define( 'WPBB_LOCATION_URL', plugins_url( '', __FILE__ ) );

// Define plugin version constant and db version constant.
define( 'WPBB_PLUGIN_VERSION', '3.0.3' );
define( 'WPBB_PLUGIN_VERSION', '3.0.4' );
define( 'WPBB_PLUGIN_DB_VERSION', 2 );

/**
Expand Down

0 comments on commit 8667863

Please sign in to comment.