l10n_domain ); ?>
include_once( rtrim( dirname( __FILE__ ), '/' ) . '/acf-required-field/required-field.php' );
*
* @author Brian Zoetewey $obj = ACF_Required_Field_Helper::singleton();
* @return ACF_Required_Field_Helper
*/
public static function singleton() {
if( !isset( self::$instance ) ) {
$class = __CLASS__;
self::$instance = new $class();
}
return self::$instance;
}
/**
* Prevent cloning of the ACF_Required_Field_Helper object
* @internal
*/
private function __clone() {
}
/**
* Language directory path
*
* Used to build the path for WordPress localization files.
* @var string
*/
private $lang_dir;
/**
* Constructor
*/
private function __construct() {
$this->lang_dir = rtrim( dirname( realpath( __FILE__ ) ), '/' ) . '/languages';
add_action( 'init', array( &$this, 'register_field' ), 5, 0 );
add_action( 'init', array( &$this, 'load_textdomain' ), 2, 0 );
}
/**
* Registers the Field with Advanced Custom Fields
*/
public function register_field() {
if( function_exists( 'register_field' ) ) {
register_field( 'ACF_Required_Field', __FILE__ );
add_action( 'wp_insert_post_data', array( &$this, 'enforce_required_fields' ), 100, 2 );
add_action( 'admin_notices', array( &$this, 'admin_notice' ), 10, 0 );
}
}
/**
* Loads the textdomain for the current locale if it exists
*/
public function load_textdomain() {
$locale = get_locale();
$mofile = $this->lang_dir . '/' . self::L10N_DOMAIN . '-' . $locale . '.mo';
load_textdomain( self::L10N_DOMAIN, $mofile );
}
/**
* Returns the global Acf class
*
* @return Acf|NULL
*/
private function get_acf() {
global $acf;
if( class_exists( 'Acf' ) && isset( $acf ) )
return $acf;
return null;
}
/**
* Determine if any required fields on the post are empty
*
* If a required field is empty, the post_status is set to draft and the post_date
* is removed.
*
* @param array $data parsed post data
* @param array $postarr raw post data
* @return array
*/
public function enforce_required_fields( $data, $postarr ) {
if( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE )
return $data;
if( in_array( $data[ 'post_status' ], array('auto-draft', 'draft', 'trash') ) )
return $data;
$post_id = array_key_exists( 'ID', $postarr ) ? intval( $postarr[ 'ID' ] ) : 0;
if( $post_id === 0 )
return $data;
$acf = $this->get_acf();
$has_empty_field = false;
foreach( $this->get_required_fields( $post_id ) as $field ) {
//Update the value for the required field. ACF does this later in the save process. We do it here so we can override as necessary.
$acf->update_value(
$post_id,
$field,
( array_key_exists( 'fields', $_POST ) && array_key_exists( $field[ 'key' ], $_POST[ 'fields' ] ) ) ? stripslashes_deep( $_POST[ 'fields' ][ $field[ 'key' ] ] ) : ''
);
$value = $acf->get_value( $post_id, $field );
if( empty( $value ) )
$has_empty_field = true;
}
if( $has_empty_field ) {
$data[ 'post_status' ] = 'draft';
$data[ 'post_date' ] = current_time('mysql');
$data[ 'post_date_gmt' ] = '0000-00-00 00:00:00';
add_action( 'redirect_post_location', array(&$this, 'update_redirect_location'), 10, 2 );
}
return $data;
}
/**
* Modify the post redirect URL if any required fields are empty
*
* @param string $location url
* @param int $post_id
* @return string
*/
public function update_redirect_location( $location, $post_id ) {
remove_action( 'redirect_post_location', array(&$this, 'update_redirect_location') );
return add_query_arg( array(
'message' => false, //delete the message param
'required_fields' => '1', //Add the required_fields param
), $location);
}
/**
* Displays the Required Fields missing admin notice
*/
public function admin_notice() {
if( array_key_exists( 'required_fields', $_REQUEST ) && intval( $_REQUEST[ 'required_fields' ] ) === 1 ) {
echo sprintf(
'%1$s