functions.php

<?php
/* Functions and stuff for the WP-Dimension theme

   Based on HTML5up html5up.net

   mods by and blame go to http://cog.dog
*/


// --------- theme setup ----------------------------------------------------------------
add_action( 'after_setup_theme', 'dimension_setup' );

// better title support https://make.wordpress.org/core/2014/10/29/title-tags-in-4-1/
function dimension_setup() {
   add_theme_support( 'title-tag' );

   // give us thumbnails and righteous sizes
	add_theme_support( 'post-thumbnails' );
	set_post_thumbnail_size( 480, 200, true );
	add_image_size( 'page-thumb', 960, 400, true );

	// give us custom headers (that we will sneakily use as background
	$defaults = array(
		'default-image'          => '',
		'width'                  => 1568,
		'height'                 => 1024,
		'uploads'                => true,
		'random-default'         => false,
		'header-text'            => false,
	);

	add_theme_support( 'custom-header', $defaults );

}



// --------- rebrand posts ---------------------------------------------------------------

// change the name of admin menu items from "Posts" to be "Front Boxes"
// -- h/t https://wordpress.stackexchange.com/a/9224/14945

// change the prompts and stuff for posts to be relevant to Front Boxes

add_action( 'init', 'dimension_change_post_object' );

function dimension_change_post_object() {

    $thing_name = 'Front Box';

    global $wp_post_types;
    $labels = &$wp_post_types['post']->labels;
    $labels->name =  $thing_name . 'es';
    $labels->singular_name =  $thing_name;
    $labels->add_new = 'Add ' . $thing_name;
    $labels->add_new_item = 'Add ' . $thing_name;
    $labels->edit_item = 'Edit ' . $thing_name;
    $labels->new_item =  $thing_name;
    $labels->view_item = 'View ' . $thing_name;
    $labels->search_items = 'Search ' . $thing_name;
    $labels->not_found = 'No ' . $thing_name . ' found';
    $labels->not_found_in_trash = 'No ' .  $thing_name . ' found in Trash';
    $labels->all_items = 'All ' . $thing_name . 'es';
    $labels->menu_name =  $thing_name . 'es';
    $labels->name_admin_bar =  $thing_name;
    $labels->attributes = $thing_name . ' Properties';
}

// edit the post editing admin messages to reflect use of Front Boxes
// h/t http://www.joanmiquelviade.com/how-to-change-the-wordpress-post-updated-messages-of-the-edit-screen/


add_filter( 'post_updated_messages', 'dimension_post_updated_messages', 10, 1 );

function dimension_post_updated_messages ( $msg ) {
    $msg[ 'post' ] = array (
         0 => '', // Unused. Messages start at index 1.
	 1 => "Front Box updated.",
	 2 => 'Custom field updated.',  // Probably better do not touch
	 3 => 'Custom field deleted.',  // Probably better do not touch

	 4 => "Front Box updated.",
	 5 => "Front Box restored to revision",
	 6 => "Front Box published.",

	 7 => "Front Box saved.",
	 8 => "Front Box submitted.",
	 9 => "Front Box scheduled.",
	10 => "Front Box draft updated.",
    );
    return $msg;
}

// --------- add menu location -----------------------------------------------------------


add_action( 'init', 'dimension_register_my_menu' );

function dimension_register_my_menu() {
	register_nav_menu( 'dimension-social', __( 'Social Media' ) );
}

// --------- ordering boxes --------------------------------------------------------------


// add  order to posts aka "front boxes"
function dimension_posts_order() {
    add_post_type_support( 'post', 'page-attributes' );
}

add_action( 'admin_init', 'dimension_posts_order' );


// add post order to posts aka "front boxes"
function dimension_columns_show_columns($name) {
    global $post;

    switch ($name) {
        case 'order':
            $views = $post->menu_order;
            echo $views;
            break;
    }
}


// Sort posts in posts view by menu_order in ascending or descending order.
// h/t http://wordpress.stackexchange.com/questions/66455/how-to-change-order-of-posts-in-admin

add_action('manage_posts_custom_column',  'dimension_columns_show_columns');


function custom_post_order($query){
    /*
        Set post types.
        _builtin => true returns WordPress default post types.
        _builtin => false returns custom registered post types.
    */
    $post_types = get_post_types(array('_builtin' => true), 'names');
    /* The current post type. */
    $post_type = $query->get('post_type');
    /* Check post types. */
    if(in_array($post_type, $post_types)){
        /* Post Column: e.g. title */
        if($query->get('orderby') == ''){
            $query->set('orderby', 'menu_order');
        }
        /* Post Order: ASC / DESC */
        if($query->get('order') == ''){
            $query->set('order', 'ASC');
        }
    }
}

if (is_admin()){
    add_action('pre_get_posts', 'custom_post_order');
}

// organize the admin view; removed date / category, insert slide order columns
// h/t http://stackoverflow.com/questions/27602116/how-to-add-order-column-in-page-admin-wordpress


add_filter('manage_posts_columns', 'dimension_columns');

function dimension_columns($columns) {

	$dimension_columns = array();

	foreach( $columns as $key => $value) {

		if ( $key != 'date' and $key != 'categories' ) $dimension_columns[$key] = $value;
		if ( $key== 'title' ) {
			$dimension_columns['order'] = ' Box Order';
		}
	}

    return $dimension_columns;
}

// --------- scripts and styles ----------------------------------------------------------
// enqueue the scripts'n styles... do it right!

add_action( 'wp_enqueue_scripts', 'dimension_scripts' );

function dimension_scripts() {

	// dimension CSS
	wp_register_style( 'dimension-style', get_stylesheet_directory_uri() . '/assets/css/main.css' );
	wp_enqueue_style( 'dimension-style' );

	// dimension no script CSS
	wp_register_style( 'dimension-scriptless-style', get_stylesheet_directory_uri() . '/assets/css/noscript.css' );
	wp_enqueue_style( 'dimension-scriptless-style' );

	// dimension base CSS
	wp_register_style( 'dimension-style-wp', get_stylesheet_directory_uri() . '/style.css' );
	wp_enqueue_style( 'dimension-style-wp' );

	// custom jquery down in the footer you go
	wp_register_script( 'dimension-browser' , get_stylesheet_directory_uri() . '/assets/js/browser.min.js', array( 'jquery' ), false, true );
	wp_enqueue_script( 'dimension-browser' );

	wp_register_script( 'dimension-breakpoints' , get_stylesheet_directory_uri() . '/assets/js/breakpoints.min.js', array( 'jquery' ), false, true );
	wp_enqueue_script( 'dimension-breakpoints' );


	wp_register_script( 'dimension-util' , get_stylesheet_directory_uri() . '/assets/js/util.js', array( 'jquery' ), false, true );
	wp_enqueue_script( 'dimension-util' );


	wp_register_script( 'dimension-main' , get_stylesheet_directory_uri() . '/assets/js/main.js', array( 'jquery' ), false, true );
	wp_enqueue_script( 'dimension-main' );

}


// --------- Customizer Controls  --------------------------------------------------------
/*** Customizer settings to allow editing of a front quote, customizing the footer, and ivon ***/

add_action( 'customize_register', 'dimension_register_theme_customizer' );

// register custom customizer stuff

function dimension_register_theme_customizer( $wp_customize ) {
	// Create custom panel.
	$wp_customize->add_section( 'dimension_stuff', array(
		'priority'       => 10,
		'theme_supports' => '',
		'title'          => __( 'WP-Dimension', 'dimension' ),
		'description' =>  __( 'Customize the main entry for your Dimension calling card site', 'dimension' ),
	) );



	// add setting for logo
	$wp_customize->add_setting( 'dimension_logo' );

	// add controller for logo
	$wp_customize->add_control( new WP_Customize_Image_Control( $wp_customize, 'dimension_logo', array(
		'label'    => __( 'Top Logo', 'dimension' ),
		'description' =>  __( 'Image to use for top logo (in circle)', 'dimension' ),
		'section'  => 'dimension_stuff',
		'settings' => 'dimension_logo',
) ) );

	// Add setting for quote
	$wp_customize->add_setting( 'quote_text_block', array(
		 'default'           => __( '', 'dimension' ),
		 'sanitize_callback' => 'sanitize_text'
	) );
	// Add control for quote
	$wp_customize->add_control( new WP_Customize_Control(
	    $wp_customize,
		'quote_text_block',
		    array(
		        'label'    => __( 'Quote Text', 'dimension' ),
		        'description' =>  __( 'Optional quote or text below the title and site tagline', 'dimension' ),
		        'section'  => 'dimension_stuff',
		        'settings' => 'quote_text_block',
		        'type'     => 'textarea'
		    )
	    )
	);


	// Add setting for footer
	$wp_customize->add_setting( 'footer_text_block', array(
		 'default'           => __( '', 'dimension' ),
		 'sanitize_callback' => 'sanitize_text'
	) );
	// Add control for footer
	$wp_customize->add_control( new WP_Customize_Control(
	    $wp_customize,
		'custom_footer_text',
		    array(
		        'label'    => __( 'Footer Text', 'dimension' ),
		        'description' =>  __( 'Text for leftmost part of footer', 'dimension' ),
		        'section'  => 'dimension_stuff',
		        'settings' => 'footer_text_block',
		        'type'     => 'text'
		    )
	    )
	);
	

	// Add setting for number of boxes
	$wp_customize->add_setting( 'front_box_count', array(
		 'default'           => 8,
		 'sanitize_callback' => 'absint'
	) );
	// Add control for footer
	$wp_customize->add_control( new WP_Customize_Control(
	    $wp_customize,
		'front_box_count',
		    array(
		        'label'    => __( 'Number of Boxes', 'dimension' ),
		         'description' =>  __( 'Set maximum number of front boxes to show (between 1 and 16)', 'dimension' ),
		        'section'  => 'dimension_stuff',
		        'settings' => 'front_box_count',
		        'type'     => 'number',
		        'input_attrs' => array(
   					 'min' => 1,
    				 'max' => 16
				)
		    )
	    )
	);	
	


 	// Sanitize text
	function sanitize_text( $text ) {
	    return sanitize_text_field( $text );
	}
}

// dispplay footer text
function dimension_footer_text() {
	 if ( get_theme_mod( 'footer_text_block') != "" ) {
	 	echo get_theme_mod( 'footer_text_block') . ' &bull; ';
	 }	else {
	 	echo '';
	 }
}

// display front page quote
function dimension_quote_text() {
	 if ( get_theme_mod( 'quote_text_block') != "" ) {
	 	echo '<p>' . get_theme_mod( 'quote_text_block') . '</p>';
	 }
}

// return max box count
function dimension_get_box_max() {
	 return get_theme_mod( 'front_box_count');
}


/**
 * This function assumes you have a Customizer export file in your theme directory
 * at 'data/customizer.dat'. That file must be created using the Customizer Export/Import
 * plugin found here... https://wordpress.org/plugins/customizer-export-import/
 * h/t - https://gist.github.com/fastlinemedia/9a8070b9a636e38b510f
 */

 add_action( 'after_switch_theme', 'splot_import_customizer_settings' );

function splot_import_customizer_settings()
{
	// Check to see if the settings have already been imported.
	$template = get_template();
	$imported = get_option( $template . '_customizer_import', false );

	// Bail if already imported.
	if ( $imported ) {
		return;
	}

	// Get the path to the customizer export file.
	$path = trailingslashit( get_stylesheet_directory() ) . 'data/customizer.dat';

	// Return if the file doesn't exist.
	if ( ! file_exists( $path ) ) {
		return;
	}

	// Get the settings data.
	$data = @unserialize( file_get_contents( $path ) );

	// Return if something is wrong with the data.
	if ( 'array' != gettype( $data ) || ! isset( $data['mods'] ) ) {
		return;
	}

	// Import options.
	if ( isset( $data['options'] ) ) {
		foreach ( $data['options'] as $option_key => $option_value ) {
			update_option( $option_key, $option_value );
		}
	}

	// Import mods.
	foreach ( $data['mods'] as $key => $val ) {
		set_theme_mod( $key, $val );
	}

	// Set the option so we know these have already been imported.
	update_option( $template . '_customizer_import', true );
}




// --------- Post Meta Boxes  -----------------------------------------------------------

/* add editor boxes for the post/front box labels and vuttons
	https://codex.wordpress.org/Plugin_API/Action_Reference/add_meta_boxes

	One is for the optional short name for front page didsplay, the second for building bottom buttons
*/

function dimension_add_meta_boxes( $post ) {

	add_meta_box( 'dimension_meta_box', __( 'Extra Dimension Stuff', 'dimension' ), 'dimension_build_meta_box', 'post', 'normal', 'high' );
}

add_action( 'add_meta_boxes', 'dimension_add_meta_boxes' );

function dimension_build_meta_box( $post ){

	wp_nonce_field( basename( __FILE__ ), 'dimension_meta_box_nonce' );


	// retrieve the _dimension_link current value
	$button_label = get_post_meta( $post->ID, '_button_label', true );

	// retrieve the _dimension_link current value
	$go_button_name = get_post_meta( $post->ID, '_go_button_name', true );

	// retrieve the _dimension_link current value
	$current_link = get_post_meta( $post->ID, '_dimension_link', true );

	// retrieve the _link_fa_icon current value
	$current_link_icon = get_post_meta( $post->ID, '_link_fa_icon', true );
	if ( empty( $current_link_icon ) ) $current_link_icon = 'fa-share';

	?>

			<p>
			<label for="button_label" style="font-weight:bold">Front Box Label</label><br />
			This is the short name to fit in the box links on the front of the site, if empty it will use the post title.<br />
			<input type="text" name="button_label" value="<?php echo $button_label; ?>" style="width:100%" />
			</p>


			<p>
			<label for="go_button_name" style="font-weight:bold">Go Button Label</label><br />
			<input type="text" name="go_button_name" value="<?php echo $go_button_name; ?>" style="width:100%" />
			</p>

			<p>
			<label for="dimension_link" style="font-weight:bold">Go Button Destination URL</label><br />
			<input type="text" name="dimension_link" value="<?php echo $current_link; ?>" style="width:100%" />
			</p>

			<p>
			<label for="link_fa_icon"  style="font-weight:bold">Font Awesome Button Icon</label><br />
			Use a <a href="https://fontawesome.com/cons?d=gallery&p=2&s=solid&m=free" target="_blank">Font Awesome Solid icon</a> on the link button, enter class name e.g. <em>fa-car</em> or <em>fa-share</em><br />
			<input type="text" name="link_fa_icon" value="<?php echo $current_link_icon; ?>" />
			</p>

<?php
}

function dimension_save_meta_boxes_data( $post_id ) {

    // Checks save status
    $is_autosave = wp_is_post_autosave( $post_id );
    $is_revision = wp_is_post_revision( $post_id );

    // got nonce?
    $is_valid_nonce = ( isset( $_POST[ 'dimension_meta_box_nonce' ] ) && wp_verify_nonce( $_POST[ 'dimension_meta_box_nonce' ], basename( __FILE__ ) ) ) ? 'true' : 'false';

    // Exits if faux save status
    if ( $is_autosave || $is_revision || !$is_valid_nonce ) return;

	// editors only
	if ( ! current_user_can( 'edit_post', $post_id ) ) return;

	// update page name label
	if ( isset( $_REQUEST['button_label'] ) ) {
		update_post_meta( $post_id, '_button_label', sanitize_text_field( $_POST['button_label'] ) );
	}

	// update go button label
	if ( isset( $_REQUEST['go_button_name'] ) ) {
		update_post_meta( $post_id, '_go_button_name', sanitize_text_field( $_POST['go_button_name'] ) );
	}

	// update link meta data
	if ( isset( $_REQUEST['dimension_link'] ) ) {
		update_post_meta( $post_id, '_dimension_link', sanitize_text_field( $_POST['dimension_link'] ) );
	}

	// update icon meta data
	if ( isset( $_REQUEST['link_fa_icon'] ) ) {
		update_post_meta( $post_id, '_link_fa_icon', sanitize_text_field( $_POST['link_fa_icon'] ) );
	}

}

add_action( 'save_post', 'dimension_save_meta_boxes_data', 10, 2 );

// --------- shortcodes  ----------------------------------------------------------------


// generate buttons as needed
add_shortcode("linkbutton", "dimension_button");

function dimension_button( $atts ) {

 	// use the theme styles to insert a link button.
 	extract( shortcode_atts( array( "url" => "#", "text" => "Go", "special" => "", "icon" => ""), $atts ) );

	$button_class = 'button';
	if ( !empty( $special ) ) $button_class .= ' special';
	if ( !empty( $icon ) ) $button_class .= ' icon ' . $icon;

	return ('<p class="align-center"><a href="' . $url . '" class="' . $button_class . '">' . $text . '</a></p>');

}

// Load plugin requirements file to display admin notices.
require get_stylesheet_directory() . '/includes/splot-plugins.php';

?>