jboullion, Author at JBoullion

ACF Gallery Saved to Specific Folder

Recently we had a client that wanted to make sure all of the files in one of their galleries was in a specific directory instead of the default upload/year/month directory.

Here is a simple function to make sure that happens, including updating all previous files uploaded to that gallery.

/**
 * Update the file path of Custom files so that they always are located in the Custom folder
 */
add_action('acf/save_post', 'jb_update_gallery_fields', 1);
function jb_update_gallery_fields( $post_id ) {

	// specific new field value
	$gallery = $_POST['acf']['field_234567890dfghj'];

	if(! empty($gallery)){
		$folder = sanitize_file_name( get_the_title($post_id) );
		$model_dir = '/Custom/'.$folder.'/';
		$uploads = wp_upload_dir();
		$path = $uploads['basedir'] . $model_dir;

		if (! file_exists($path)) {
			mkdir($path, 0777, true);
		}
		
		foreach($gallery as $attachment_id){
			$fullsize_path = get_attached_file( $attachment_id );
			
			//is this attachment in the Custom folder?
			if (strpos($fullsize_path, 'Custom') === false) {
				$new_filepath = $path.basename($fullsize_path);

				//Not in the Custom folder
				rename($fullsize_path, $new_filepath);
				update_attached_file( $attachment_id, $new_filepath );
			}
		}
	}
}

/**

* Update the file path of Custom files so that they always are located in the Custom folder

add_action('acf/save_post', 'jb_update_gallery_fields', 1);

function jb_update_gallery_fields( $post_id ) {

// specific new field value

$gallery = $_POST['acf']['field_234567890dfghj'];

if(! empty($gallery)){

$folder = sanitize_file_name( get_the_title($post_id) );

$model_dir = '/Custom/'.$folder.'/';

$uploads = wp_upload_dir();

$path = $uploads['basedir'] . $model_dir;

if (! file_exists($path)) {

mkdir($path, 0777, true);

}

foreach($gallery as $attachment_id){

$fullsize_path = get_attached_file( $attachment_id );

//is this attachment in the Custom folder?

if (strpos($fullsize_path, 'Custom') === false) {

$new_filepath = $path.basename($fullsize_path);

//Not in the Custom folder

rename($fullsize_path, $new_filepath);

update_attached_file( $attachment_id, $new_filepath );

}

JS Capitalize a String

Just a simple String prototype to capitalize the first letter of the string.

/**
 * Capitalize the first letter of a string
 * usage: str.capitalize()
 */
String.prototype.capitalize = function() {
	return this.charAt(0).toUpperCase() + this.slice(1);
}

/**

* Capitalize the first letter of a string

* usage: str.capitalize()

String.prototype.capitalize = function() {

return this.charAt(0).toUpperCase() + this.slice(1);

}

Convert Form to JS Object

Every have a form you get the data from so you can manipulate it in JS? Good news! Dave over at Stack Overflow has the function for you!

/**
 * Take a form and convert it into a Object for easy manipulation
 * 
 * @link https://stackoverflow.com/a/23315254
 * @link http://jsfiddle.net/akhildave/sxGtM/5002/
 */
$.fn.serializeObject = function() {
	var o = {};
	var a = this.serializeArray();
	$.each(a, function() {
		if (o[this.name] !== undefined) {
			if (!o[this.name].push) {
				o[this.name] = [o[this.name]];
			}
			o[this.name].push(this.value || '');
		} else {
			o[this.name] = this.value || '';
		}
	});
	return o;
};

/**

* Take a form and convert it into a Object for easy manipulation

* @link https://stackoverflow.com/a/23315254

* @link http://jsfiddle.net/akhildave/sxGtM/5002/

$.fn.serializeObject = function() {

var o = {};

var a = this.serializeArray();

$.each(a, function() {

if (o[this.name] !== undefined) {

if (!o[this.name].push) {

o[this.name] = [o[this.name]];

}

o[this.name].push(this.value || '');

} else {

o[this.name] = this.value || '';

}

});

return o;

};

Usage is as simple as:

var formObject= $(‘form’).serializeObject();

Requires jQuery

Unfortunately when you are doing a custom query in WordPress by default you can’t search by the “s” parameter and a meta_query. A common technique was to just do two queries and merge them. That works, but it is not efficient.

User Satbir Kira over at StackOverflow posted this great solution. Simply add this function to your functions.php file and replace the “s” parameter in your custom query with a “_meta_or_title” parameter.

add_action( 'pre_get_posts', function( $q ) {
	if( $title = $q->get( '_meta_or_title' ) )
	{
		add_filter( 'get_meta_sql', function( $sql ) use ( $title )
		{
			global $wpdb;

			// Only run once:
			static $nr = 0; 
			if( 0 != $nr++ ) return $sql;

			// Modified WHERE
			$sql['where'] = sprintf(
				" AND ( %s OR %s ) ",
				$wpdb->prepare( "{$wpdb->posts}.post_title like '%%%s%%'", $title),
				mb_substr( $sql['where'], 5, mb_strlen( $sql['where'] ) )
			);

			return $sql;
		});
	}
});

add_action( 'pre_get_posts', function( $q ) {

if( $title = $q->get( '_meta_or_title' ) )

{

add_filter( 'get_meta_sql', function( $sql ) use ( $title )

{

global $wpdb;

// Only run once:

static $nr = 0;

if( 0 != $nr++ ) return $sql;

// Modified WHERE

$sql['where'] = sprintf(

" AND ( %s OR %s ) ",

$wpdb->prepare( "{$wpdb->posts}.post_title like '%%%s%%'", $title),

mb_substr( $sql['where'], 5, mb_strlen( $sql['where'] ) )

);

return $sql;

});

}

});

Here is what an example query might look like.

$search_value = 'Search Me';
$paged = ( get_query_var( 'paged' ) ) ? get_query_var( 'paged' ) : 1;

$args = array(
		'post_type' 	=> 'contacts',
		'paged' 	=> $paged,
        '_meta_or_title' => $search_value,
        'meta_query' => array(
	        'relation'  => 'OR',
	        array(
		        'key' => 'office',
		        'value' => $search_value,
		        'compare' => 'LIKE'
	        ),
	        array(
		        'key' => 'title',
		        'value' => $search_value,
		        'compare' => 'LIKE'
	        ),
	        array(
		        'key' => 'email',
		        'value' => $search_value,
		        'compare' => 'LIKE'
	        )
        )
	);

//$results = new WP_Query( $args ); //need pagination?
$results = get_posts( $args ); //simple listing?

$search_value = 'Search Me';

$paged = ( get_query_var( 'paged' ) ) ? get_query_var( 'paged' ) : 1;

$args = array(

'post_type' => 'contacts',

'paged' => $paged,

'_meta_or_title' => $search_value,

'meta_query' => array(

'relation' => 'OR',

array(

'key' => 'office',

'value' => $search_value,

'compare' => 'LIKE'

array(

'key' => 'title',

'value' => $search_value,

'compare' => 'LIKE'

array(

'key' => 'email',

'value' => $search_value,

'compare' => 'LIKE'

)

);

//$results = new WP_Query( $args ); //need pagination?

$results = get_posts( $args ); //simple listing?

Limit User Role to Certain Posts

There are a variety of plugins out there for managing user role access. User Role Editor (URE) and Advanced Access Manager (AAM) are both good plugins I can recommend.URE is great for…editing roles. The problem with URE is that it doesn’t allow more narrowly scope restrictions…like to single posts. AAM is great at limiting individual posts and hiding admin menus. AAM however requires a LOT of setup if you have a lot of pages / a lot of roles and starts to become unpractical for highly restrictive page editing.

All that said, I ended up turning to good ol’ taxonomies.

First, setup your taxonomy for your posts. In this case I am targeting a “Departments” custom post type.

jb_register_cpt(array('name' => 'department', 'icon' => 'dashicons-admin-multisite', 'position' => 30, 'hierarchical' => true ));
jb_register_taxonomy('dept_admin', 'departments', 'Department Administration');

1 2	jb_register_cpt(array('name' => 'department', 'icon' => 'dashicons-admin-multisite', 'position' => 30, 'hierarchical' => true )); jb_register_taxonomy('dept_admin', 'departments', 'Department Administration');

See jp_register_cpt and jb_register_taxonomy for info on these functions.

Second, setup your roles with URE. I’ll leave this to you, but I usually start with copying either the “Contributor” or the “Subscriber” default roles and going from there. Mine looks like this:

Third, Add a new admin taxonomy in the net taxonomy you just created. Make sure to give it the same slug as the user role ID, this is just for ease of use later and for reference. Example:

Forth, add this function to your PHP file.

add_action( 'pre_get_posts', 'pk_limit_admin_posts', 1 );
function pk_limit_admin_posts( $query ) {
	global $current_user;

	if ( ! pk_is_site_admin($current_user) 
		&& is_admin() 
		&& $query->is_main_query()
		&& $query->get('post_type') == 'departments' ){
			
			$tax_query = array();
			$tax_query['relation'] = 'OR';

			//Some users will have more than one role so we need to allow multiple taxonomies to be used
			if(! empty($current_user->roles)){
				foreach($current_user->roles as $role) {
					$tax_query[] = array(
						'taxonomy' => 'dept_admin',
						'field'    => 'slug',
						'terms'    => $role,
					);
				}
			}
		
			$query->set( 'tax_query', $tax_query );
	}
}

add_action( 'pre_get_posts', 'pk_limit_admin_posts', 1 );

function pk_limit_admin_posts( $query ) {

global $current_user;

if ( ! pk_is_site_admin($current_user)

&& is_admin()

&& $query->is_main_query()

&& $query->get('post_type') == 'departments' ){

$tax_query = array();

$tax_query['relation'] = 'OR';

//Some users will have more than one role so we need to allow multiple taxonomies to be used

if(! empty($current_user->roles)){

foreach($current_user->roles as $role) {

$tax_query[] = array(

'taxonomy' => 'dept_admin',

'field' => 'slug',

'terms' => $role,

);

}

$query->set( 'tax_query', $tax_query );

}

All done! Now this user role should not be able to view or edit any posts that do not have this category.

Using TinyMCE outside of WordPress

Recently we had to setup a TinyMCE WYSIWYG outside of WordPress so we couldn’t use the wp_editor function.

TinyMCE has changed a lot since I last used it as a stand alone feature so I wanted to make a post about how to set this up so I don’t have to look around for this info again.

Step number one is setting up the script, like so

<script src='https://cloud.tinymce.com/stable/tinymce.min.js?apiKey=API_KEY'></script>

1	<script src='https://cloud.tinymce.com/stable/tinymce.min.js?apiKey=API_KEY'></script>

Unfortunately you do need to setup an account and get an API key in order to correctly use TinyMCE. You also need to setup the domains you want this script to work on, this is done in your TinyMCE account.

Once we have that in place we can setup our WYSIWYG!

<form>
    <textarea id="mytextarea" name="mytextarea"></textarea>
</form>

<script>
    tinymce.init({
        selector: '#mytextarea',
        browser_spellcheck: true,
        height: "300",
        setup: function (editor) {
            editor.on('change', function () {
                editor.save();
            })
        }
    });
</script>

<form>

</form>

tinymce.init({

selector: '#mytextarea',

browser_spellcheck: true,

height: "300",

setup: function (editor) {

editor.on('change', function () {

editor.save();

})

}

});

</script>

And there we go! That is all you need to get a basic TinyMCE instance going.

NOTE: I had to make sure I had the editor.on(‘change’) function working or else my textarea wasn’t updating quite right. You might not need this for your use case.

TinyMCE also offers additional plugins which are really neat, unfortunately they require paying a monthly subscription 🙁

If you are using TinyMCE in multiple places and NEED those plugins, it would definitely be worth it, but the default functionality is probably good enough for most users.

Author: jboullion

ACF Gallery Saved to Specific Folder

JS Capitalize a String

Convert Form to JS Object

Search Post Title and Meta

Limit User Role to Certain Posts

Using TinyMCE outside of WordPress