'Version'));
define('THEMEVERSION', $vthemeheaders['Version']);
if (!defined('THEMEPREFIX')) {define('THEMEPREFIX', 'bioship');}
// ---------------------------------
// Set WordQuest Theme 'Plugin' Info
// ---------------------------------
// 2.1.0: use 3 letters for settings prefix
global $wordquestplugins; $slug = THEMEPREFIX;
$wordquestplugins[$slug]['version'] = THEMEVERSION;
$wordquestplugins[$slug]['title'] = __('BioShip Theme','bioship');
$wordquestplugins[$slug]['settings'] = substr(THEMEPREFIX, 0, 3);
$wordquestplugins[$slug]['plan'] = 'free';
$wordquestplugins[$slug]['hasplans'] = false;
// --- WordPress.Org values ---
// note: set to false here and rechecked with THEMEWPORG constant
$wordquestplugins[$slug]['wporg'] = false;
// TODO: add this definition if/when in WordPress.Org repo
// $wordquestplugins[$slug]['wporgslug'] = 'bioship';
// ------------------
// Set Framework URLs
// ------------------
// 2.0.0: added BioShip Home URL constant
// 2.0.1: change constant name for consistency
// 2.0.1: added Support Forum Site URL constant
// 2.0.1: set Theme SSL constant here also
define('THEMEHOMEURL', 'http://bioship.space');
define('THEMESUPPORT', 'http://wordquest.org');
if (!defined('THEMESSL')) {$vthemessl = is_ssl(); define('THEMESSL', $vthemessl);}
// -------------------------------------
// Set Global Theme Directories and URLs
// -------------------------------------
// 1.8.0: use directory separator not trailingslashit for directories
// 1.9.0: added 'theme' prefix to all global names
global $vthemestyledir, $vthemestyleurl, $vthemetemplatedir, $vthemetemplateurl;
$vthemestyledir = get_stylesheet_directory().DIRSEP;
$vthemestyleurl = trailingslashit(get_stylesheet_directory_uri());
$vthemetemplatedir = get_template_directory().DIRSEP;
$vthemetemplateurl = trailingslashit(get_template_directory_uri());
// 1.8.0: enforce SSL recheck of theme URLs
if (THEMESSL) {
$vthemestyleurl = str_replace('http://', 'https://', $vthemestyleurl);
$vthemetemplateurl = str_replace('http://', 'https://', $vthemetemplateurl);
}
// ------------------------------
// Set Constant for Windows Paths
// ------------------------------
// (may help paths on some local dev Windows IIS environments)
// 2.0.9: use operating system check for Windows paths
if (!defined('THEMEWINDOWS')) {
if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {define('THEMEWINDOWS', true);}
else {define('THEMEWINDOWS', false);}
}
if (THEMEWINDOWS) {
$vthemetemplatedir = str_replace('/', '\\' ,$vthemetemplatedir);
$vthemestyledir = str_replace('/', '\\', $vthemestyledir);
}
// -------------------------
// Set Global Resource Paths
// -------------------------
// 1.8.0: used for inbuilt file hierarchy calls
// 1.8.5: set defaults and filter later on (to allow for filters.php)
// 1.9.5: add scripts and styles to top of hierarchy
// 2.1.1: added includes theme directory paths
global $vthemedirs;
$vthemedirs['core'] = array();
$vthemedirs['admin'] = array('admin');
$vthemedirs['style'] = array('styles', 'css', 'assets/css');
$vthemedirs['script'] = array('scripts', 'javascripts', 'js', 'assets/js');
$vthemedirs['image'] = array('images', 'img', 'icons', 'assets/img');
$vthemedirs['includes'] = array('includes');
// ------------------------
// === Helper Functions ===
// ------------------------
// ----------------------
// Negative return Helper
// ----------------------
// 2.0.7: added this little helper function
if (!function_exists('bioship_return_negative')) {
function bioship_return_negative() {return -1;}
}
// ---------------------
// Dummy Function Helper
// ---------------------
// 2.0.9: added this little helper function
if (!function_exists('bioship_dummy_function')) {
function bioship_dummy_function() {}
}
// ----------------
// Start Load Timer
// ----------------
if (!function_exists('bioship_timer_start')) {
function bioship_timer_start() {
global $vthemetimestart; $vthemetimestart = microtime(true); return $vthemetimestart;
}
$vthemetimestart = bioship_timer_start();
}
// ---------------------
// Get Current Load Time
// ---------------------
if (!function_exists('bioship_timer_time')) {
function bioship_timer_time() {
global $vthemetimestart; $themetimer = microtime(true); return ($themetimer - $vthemetimestart);
}
}
// ---------------------
// Get Remote IP Address
// ---------------------
if (!function_exists('bioship_get_remote_ip')) {
function bioship_get_remote_ip() {
if (THEMETRACE) {bioship_debug('F',__FUNCTION__,__FILE__);}
// TODO: replace with more accurate IP detection ?
// note: this is only used by the theme in debug log lines
if (!empty($_SERVER['HTTP_CLIENT_IP'])) {$ip = $_SERVER['HTTP_CLIENT_IP'];}
elseif (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {$ip = $_SERVER['HTTP_X_FORWARDED_FOR'];}
else {$ip = $_SERVER['REMOTE_ADDR'];}
return $ip;
}
}
// ------------------
// Theme Debug Output
// ------------------
// 2.0.9: added separate debug output/logging function
if (!function_exists('bioship_debug')) {
function bioship_debug($prefix, $data=NULL, $forceoutput = null, $forcelog = null) {
if (!defined('THEMEDEBUG') || !THEMEDEBUG) {return;}
// --- maybe display debug output ---
$output = true;
if (defined('THEMEDEBUGOUTPUT') && !THEMEDEBUGOUTPUT) {$output = false;}
if (!is_null($forceoutput)) {$output = $forceoutput;}
// --- maybe output debug data ---
if ($output) {
echo "".PHP_EOL;
}
// --- check for debug instance ---
// 2.0.9: check querystring for setting of debug instance
if (!defined('THEMEDEBUGINSTANCE') && isset($_REQUEST['instance'])) {
define('THEMEDEBUGINSTANCE', $_REQUEST['instance']);
}
// --- maybe log debug output ---
// 2.1.1: added missing single quotes in define check
$log = false;
if (defined('THEMEDEBUGLOG') && THEMEDEBUGLOG) {$log = true;}
if (!is_null($forcelog)) {$log = $forcelog;}
// 2.1.1: bug out here if not logging
if (!$log) {return;}
$logline = '';
// --- theme debug log info constant ---
// (define for once only logging)
if (!defined('THEMEDEBUGLOGINFO')) {
$logline = PHP_EOL."Theme Debug Output";
if (defined('THEMEDEBUGINSTANCE') && THEMEDEBUGINSTANCE) {
$logline .= " Instance '".THEMEDEBUGINSTANCE."'";
}
$logline .= PHP_EOL.'['.date('j m Y H:i:s', time()).'] ';
// --- user IP address ---
// 2.0.9: add IP address to theme debug info log line
$logline .= '[IP '.bioship_get_remote_ip().'] ';
define('THEMEDEBUGLOGINFO', true);
}
// --- set log line data ---
$logline .= $prefix;
if (!is_null($data)) {
if (is_string($data)) {$logline .= ": ".$data;}
elseif (is_array($data) || is_object($data)) {
// 2.0.9: removed unneeded output buffering
$logline .= ": ".PHP_EOL.print_r($data, true);
}
}
$logline .= PHP_EOL;
if ($logline != '') {
// --- set debug log filename ---
// 2.1.1: check/set THEMEDEBUGFILE constant
if (defined('THEMEDEBUGFILE')) {$filename = THEMEDEBUGFILE;}
else {
$filename = 'theme_debug.log';
// 2.0.9: allow setting of alternative filename for single debug instance
if (defined('THEMEDEBUGINSTANCE') && THEMEDEBUGINSTANCE) {
$instance = THEMEDEBUGINSTANCE;
$filename = $instance.'_'.$filename;
} else {$instance = false;}
// --- filter debug log filename ---
// 2.1.1: added instance as extra filter value
$filename = bioship_apply_filters('debug_filename', $filename, $instance);
define('THEMEDEBUGFILE', $filename);
}
// --- write log line to debug file ---
bioship_write_debug_file($filename, $logline);
}
}
}
// -----------------
// Get File Contents
// -----------------
// 2.0.7: added file_get_contents alternative wrapper (for Theme Check)
if (!function_exists('bioship_file_get_contents')) {
function bioship_file_get_contents($filepath) {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__,func_get_args());}
if (!file_exists($filepath)) {return '';}
// --- attempt to use WP filesystem ---
global $wp_filesystem;
if (empty($wp_filesystem)) {
// --- maybe require filesystem ---
if (!function_exists('WP_Filesytem')) {
$filesystem = ABSPATH.DIRSEP.'wp-admin'.DIRSEP.'includes'.DIRSEP.'file.php';
require_once($filesystem);
}
// --- initialize WP Filesystem ---
WP_Filesystem();
}
// --- get file contents ---
$contents = $wp_filesystem->get_contents($filepath);
if ($contents) {return $contents;}
else {
// --- fallback to using file() to read the file ---
$filearray = @file($filepath);
if (!$filearray) {return '';}
// 2.1.1: do not re-add lines for file function
$contents = implode("", $filearray);
return $contents;
}
}
}
// ------------------
// Direct File Writer
// ------------------
// 1.8.0: added this for direct file writing
// 2.0.9: added append method since WP Filesystem does not have one
if (!function_exists('bioship_write_to_file')) {
function bioship_write_to_file($filepath, $data, $append=false) {
// 2.1.1: fix for early use of this function (where tracer not loaded yet)
// if (defined('THEMETRACE') && THEMETRACE && function_exists('bioship_trace')) {
// bioship_trace('F',__FUNCTION__,__FILE__);
// }
// --- force direct-only write method using WP Filesystem ---
global $wp_filesystem;
if (empty($wp_filesystem)) {
// --- maybe require filesystem ---
if (!function_exists('WP_Filesytem')) {
// 2.0.9: fix to double trailing slash on WP filesystem path
$filesystem = ABSPATH.'wp-admin'.DIRSEP.'includes'.DIRSEP.'file.php';
require_once($filesystem);
}
// --- initialize WP Filesystem ---
WP_Filesystem();
}
$filedir = dirname($filepath);
// --- get filesystem credentials ---
$credentials = request_filesystem_credentials('', 'direct', false, $filedir, null);
if ($credentials === false) {
// --- bug out since we cannot do direct writing ---
bioship_debug("WP Filesystem Direct Write Method Failed. Check Owner/Group Permissions.");
return false;
}
// --- append method ---
// note: used in debug line writing
// 2.0.9: added as bizarrely WP Filesystem has no append method??
// 2.1.1: double check file exists before getting content
if ($append && file_exists($filepath)) {
$contents = $wp_filesystem->get_contents($filepath);
$data = $contents.PHP_EOL.$data;
}
// --- write to file --
// 2.1.1: return write result
$result = $wp_filesystem->put_contents($filepath, $data, FS_CHMOD_FILE);
return $result;
}
}
// -----------------
// Debug File Writer
// -----------------
// 1.8.0: added this for tricky debugging output
// 1.9.8: use debug directory global here
// 2.1.1: added optional append argument
if (!function_exists('bioship_write_debug_file')) {
function bioship_write_debug_file($filename, $data, $append=true) {
// if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__);}
// -- check/create debug directory --
global $vthemedebugdir;
$vthemedebugdir = bioship_check_create_debug_dir();
// --- write debug file ---
$debugfile = $vthemedebugdir.DIRSEP.$filename;
// 2.0.9: use new append writing method for debug data
$writedebug = bioship_write_to_file($debugfile, $data, $append);
// --- error log writing fallback ---
// 2.0.9: fallback using error_log if WP Filesystem direct method failed
if (!$writedebug) {error_log($data, 3, $debugfile);}
}
}
// ----------------------------
// Check/Create Debug Directory
// ----------------------------
// 2.0.9: moved to standalone function from bioship_write_debug_file
if (!function_exists('bioship_check_create_debug_dir')) {
function bioship_check_create_debug_dir() {
// if (defined('THEMETRACE') && THEMETRACE && function_exists('bioship_trace')) {
// bioship_trace('F',__FUNCTION__,__FILE__);
// }
// --- maybe create debug directory ---
global $vthemedebugdir, $vthemestyledir, $vthemetemplatedir;
if (!isset($vthemedebugdir)) {
if (is_child_theme()) {$vthemedebugdir = $vthemestyledir.'debug';}
else {$vthemedebugdir = $vthemetemplatedir.'debug';}
$vthemedebugdir = bioship_apply_filters('skeleton_debug_dirpath', $vthemedebugdir);
if (!is_dir($vthemedebugdir)) {
// TODO: maybe use WP Filesystem to create debug directory ?
wp_mkdir_p($vthemedebugdir);
}
}
// --- write htaccess file ---
// 2.0.7: check and write .htaccess file for debug directory
$htacontents = "order deny,allow".PHP_EOL."deny from all";
$htafile = $vthemedebugdir.DIRSEP.'.htaccess';
if (!file_exists($htafile)) {$writehta = bioship_write_to_file($htafile, $htacontents);}
return $vthemedebugdir;
}
}
// ------------------------
// Get Current User Wrapper
// ------------------------
// 2.0.7: extracted all calls to standalone function
if (!function_exists('bioship_get_current_user')) {
function bioship_get_current_user() {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__);}
if (function_exists('wp_get_current_user')) {return wp_get_current_user();}
else {
global $current_user;
// 2.0.9: streamlined copy of _wp_get_current_user (backwards compatible)
// (as using get_currentuserinfo() does not pass theme check)
if (!empty($current_user)) {
if ($current_user instanceof WP_User) {return $current_user;}
// 2.1.1: removed setting of $current_user to null, fixed isset check
$current_user_id = 0;
if (is_object($current_user) && property_exists($current_user, 'ID')) {
$current_user_id = $current_user->ID;
}
wp_set_current_user($current_user_id);
}
return $current_user;
}
return false;
}
}
// ---------------------------------
// Apply Filters (with Value Tracer)
// ---------------------------------
// 2.1.1: added extra value argument
// note: extravalue set to an arbitrary string as a null value may be valid!
if (!function_exists('bioship_apply_filters')) {
function bioship_apply_filters($filter, $value, $extravalue = 'valuenotsupplied', $caller = false) {
// --- standard filter ---
// 2.0.5: also trace applied filter levels
// 2.1.1: check for extra filtering value
$values['in'] = $value;
if ($extravalue == 'valuenotsupplied') {$filtered = apply_filters($filter, $value);}
else {$filtered = apply_filters($filter, $value, $extravalue);}
if ($value != $filtered) {$value = $values['filter'] = $filtered;}
// --- theme prefixed filter ----
// 2.0.5: process theme prefixed filter as well
// 2.1.1: check for extra filtering value
if (substr($filter, 0, strlen(THEMEPREFIX.'_')) != THEMEPREFIX.'_') {
if ($extravalue == 'valuenotsupplied') {$filtered = apply_filters(THEMEPREFIX.'_'.$filter, $value);}
else {$filtered = apply_filters(THEMEPREFIX.'_'.$filter, $value, $extravalue);}
if ($filtered != $value) {$value = $values['theme'] = $filtered;}
}
// --- child theme prefixed filter ---
// 2.0.5: maybe process child theme specific filter (for multiple theme compatibilty)
// 2.1.1: check for extra filtering value
if (defined('THEMECHILD') && THEMECHILD) {
if (substr($filter, 0, strlen(THEMESLUG.'_')) != THEMESLUG.'_') {
if ($extravalue == 'valuenotsupplied') {$filtered = apply_filters(THEMESLUG.'_'.$filter, $value);}
else {$filtered = apply_filters(THEMESLUG.'_'.$filter, $value, $extravalue);}
if ($filtered != $value) {$value = $values['child'] = $filtered;}
}
}
// --- trace value only if changed ---
if (defined('THEMETRACE') && THEMETRACE) {
$values['out'] = $value;
bioship_trace('V', $filter, $caller, $values);
}
return $value;
}
}
// -----------------------
// Do Action (with Tracer)
// -----------------------
// 2.0.5: added prefixed do_action wrapper for action load debugging/tracing
if (!function_exists('bioship_do_action')) {
function bioship_do_action($action) {
// --- action tracer ---
// 2.1.1: removed useless third argument value
// (as will always be functions.php, current template filepath used instead)
if (THEMETRACE) {bioship_trace('A',$action,'');}
// --- action hook debugging ---
if (THEMEDEBUG) {
$list = '';
if (has_action($action)) {
global $wp_filter;
$callbacks = $wp_filter[$action]->callbacks;
if (count($callbacks) > 0) {
foreach ($callbacks as $priority => $callback) {
foreach ($callback as $key => $function) {
$list .= $function['function'].' ('.$priority.')'.PHP_EOL;
}
}
}
}
// --- debug the hooked action list ---
// 2.0.9: use bioship_debug function
if ($list == '') {bioship_debug("Doing Empty Action '".$action."'");}
else {bioship_debug("Doing Action '".$action."' with Hooked Functions", $list);}
}
// --- just do it already ---
do_action($action);
}
}
// --------------------------------
// Add to Action Hook with Priority
// --------------------------------
// 1.9.8: added abstract to use theme hooks array
if (!function_exists('bioship_add_action')) {
function bioship_add_action($hook, $function, $defaultposition) {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__,func_get_args());}
global $vthemehooks;
// --- add theme prefix ---
// 2.0.5: maybe auto-prefix hooks and functions
$prefix = THEMEPREFIX.'_';
if (substr($hook, 0, strlen($prefix)) != $prefix) {$hook = $prefix.$hook;}
if (substr($function, 0, strlen($prefix)) != $prefix) {$function = $prefix.$function;}
// --- check theme hooks array ---
if (isset($vthemehooks['functions'][$hook][$function])) {
$position = $vthemehooks['functions'][$hook][$function];
} else {
$position = $defaultposition;
bioship_debug("Warning: Missing Template Position for Hook ".$hook, $function);
}
// --- apply old filter names ---
// 2.0.5: for old position filters eg. skeleton_wrapper_open_position
$oldfunction = substr($function, strlen(THEMEPREFIX.'_'), strlen($function));
$position = apply_filters($oldfunction.'_position', $position);
// --- apply position filters ---
if (function_exists('bioship_apply_filters')) {
// eg. bioship_wrapper_open_position
$position = bioship_apply_filters($function.'_position', $position);
// eg. bioship_container_open_bioship_wrapper_open_position
$position = bioship_apply_filters($hook.'_'.$function.'_position', $position);
} else {
$position = apply_filters($function.'_position', $position);
$position = apply_filters($hook.'_'.$function.'_position', $position);
}
// --- add action to hook with priority ---
if ($position > -1) {
bioship_debug("Added to Hook ".$hook." with Priority ".$position, $function, true);
add_action($hook, $function, $position);
} else {
bioship_debug("Invalid Position for Hook ".$hook." at ".$position, $function, true);
}
}
}
// ------------------------
// Register Removed Actions
// ------------------------
// helper to remove template action from hook without needing to know priority position
// 2.0.5: added this remove_action helper wrapper
if (!function_exists('bioship_remove_action')) {
function bioship_remove_action($hook, $function, $position=false) {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__,func_get_args());}
global $vthemehooks;
// --- auto-add theme prefix ---
$prefix = THEMEPREFIX.'_';
if (substr($hook, 0, strlen($prefix)) != $prefix) {$hook = $prefix.$hook;}
if (substr($function, 0, strlen($prefix)) != $prefix) {$function = $prefix.$function;}
// --- find action hook position ---
if (!$position) {
if (!isset($vthemehooks['functions'][$hook][$function])) {
$position = $vthemehooks['functions'][$hook][$function];
}
// --- apply position filters ---
// note: position filters intentionally reversed as removing not adding!
if (function_exists('bioship_apply_filters')) {
$position = bioship_apply_filters($hook.'_'.$function.'_position', $position);
$position = bioship_apply_filters($function.'_position', $position);
} else {
$position = apply_filters($hook.'_'.$function.'_position', $position);
$position = apply_filters($function.'_position', $position);
}
}
// --- add to list of actions to remove later ---
// 2.1.1: added recheck of position false for edge cases
if ($position && ($position > -1)) {
// remove_action($hook, $function, $position);
$vthemehooks['remove'][$hook][$function] = $position;
}
}
}
// ----------------------
// Delayed Remove Actions
// ----------------------
if (!function_exists('bioship_remove_actions')) {
// --- delay until init so actions added then removed ---
// 2.0.9: increase priority for better child theme support
add_action('init', 'bioship_remove_actions', 11);
function bioship_remove_actions() {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__);}
global $vthemehooks;
$remove = $vthemehooks['remove'];
if (count($remove) > 0) {
foreach ($remove as $hook) {
foreach ($hook as $function => $position) {
remove_action($hook, $function, $position);
bioship_debug("Action Removed from Hook ".$hook." Position ".$position, $function);
}
}
}
}
}
// -----------------
// Get Single Option
// -----------------
// note: for internal theme use, does not honour pre_option_ or default_option filters!
// 1.9.5: added to get an option direct from database (to bypass any cached values)
// 2.0.9: add default (not yet used) and filter arguments
if (!function_exists('bioship_get_option')) {
function bioship_get_option($optionkey, $default=false, $filter=true) {
if (defined('THEMETRACE') && THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__,func_get_args());}
// --- get value direct from database ---
global $wpdb;
$query = "SELECT option_value FROM ".$wpdb->prefix."options WHERE option_name = '".$optionkey."'";
// --- maybe unserialize option value
// 2.0.9: always do a maybe_unserialize on option value
$optionvalue = maybe_unserialize($wpdb->get_var($query));
// --- apply filter to value ---
// 2.0.9: maybe apply the related option filter
if ($filter) {$optionvalue = apply_filters('option_'.$optionkey, $optionvalue, $optionkey);}
return $optionvalue;
}
}
// ----------------------------
// Comprehensive File Hierarchy
// ----------------------------
// ...a magical fallback mystery tour...
// 1.8.0: use DIRECTORY_SEPARATOR in all paths
// 1.8.0: switch to directory array loop instead of 2 args
// 1.8.0: added optional search roots override argument
// (added for edge cases, ie. the search for /sidebar/page.php should *not* find /page.php)
// 2.0.9: added theme_file_search filter to return results?
if (!function_exists('bioship_file_hierarchy')) {
function bioship_file_hierarchy($type, $filename, $dirs = array(), $searchroots = array('stylesheet','template')) {
// 1.6.0: check if THEMETRACE constant is defined (in this function only!)
if (defined('THEMETRACE') && THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__,func_get_args());}
global $vthemestyledir, $vthemestyleurl, $vthemetemplatedir, $vthemetemplateurl;
// 1.8.5: just in case of bad argument fix ("I'm right", "No, I'm right!" ...)
if (!is_array($searchroots)) {$searchroots = array('stylesheet', 'template');}
// --- replacement for windows paths ---
// 1.8.0: just use THEMEWINDOWS constant here instead of everywhere else...
// 2.0.1: use numerical index when looping array
$filedirs = $dirs;
if (THEMEWINDOWS && (count($dirs) > 0)) {
foreach ($dirs as $i => $dir) {$filedirs[$i] = str_replace('/', '\\', $dir);}
}
// --- debug hierarchy call and search directories ---
if (defined('THEMEDEBUG')) {
bioship_debug("File Hierarchy Call for ".$type, $filename);
if (count($dirs) > 0) {bioship_debug("Search Directories", implode(',', $dirs));}
}
// --- set value flags ---
// 2.0.9: set default value flag
// 2.1.0: set default found flag
// 2.1.1: removed unnecessary double flag
$value = false;
// --- check stylesheet subdirectory(s) loop ---
if (count($dirs) > 0) {
foreach ($dirs as $i => $dir) {
// 2.0.9: check for found value (stored for filtering)
if (!$value) {
$file = false;
// 1.8.0: added absolute path override possibility (prototype)
// (can be used via resource directory override filters)
// note: to work full absolute path must start and end with #
if (strstr($dir, '#')) {
if ( (substr($dir, 0 ,1) == '#') && (substr($dir, -1) == '#') ) {
$absdir = substr($dir, 1, -1);
$file = $absdir.$filename;
// TODO: check/improve this URL to path replacement ?
$url = str_replace(ABSPATH, site_url(), $file);
}
} elseif ($dir == '') {
// 1.8.0: allow for root file to take precedence if specified
$file = $vthemestyledir.$filename;
$url = $vthemestyleurl.$filename;
} else {
$file = $vthemestyledir.$filedirs[$i].DIRSEP.$filename;
$url = trailingslashit($vthemestyleurl.$dir).$filename;
}
// 2.1.1: moved repeated logic out from if statements
if ($file && file_exists($file)) {
if ($type == 'file') {$value = $file;}
elseif ($type == 'url') {$value = $url;}
elseif ($type == 'both') {$value = array('file' => $file, 'url' => $url);}
}
}
}
}
// --- fallback check of stylesheet base directory ---
if (!$value && in_array('stylesheet', $searchroots)) {
$file = $vthemestyledir.$filename;
$url = $vthemestyleurl.$filename;
if (file_exists($file)) {
if ($type == 'file') {$value = $file;}
elseif ($type == 'url') {$value = $url;}
elseif ($type == 'both') {$value = array('file' => $file, 'url' => $url);}
}
}
// --- check template subdirectory(s) loop ---
// 1.8.0: bug out early if the template and stylesheet directory are the same (no child theme)
// 2.1.1: combined with child theme check conditions to enable later filtering
if (!$value && ($vthemestyledir != $vthemetemplatedir)) {
if (count($dirs) > 0) {
foreach ($dirs as $i => $dir) {
// 2.0.9: check for found value (stored for filtering)
if (!$value) {
$file = false;
// 1.8.0: allow for root file to take precedence if specified
if ($dir == '') {
$file = $vthemetemplatedir.$filename;
$url = $vthemetemplateurl.$filename;
} else {
$file = $vthemetemplatedir.$filedirs[$i].DIRSEP.$filename;
$url = trailingslashit($vthemetemplateurl.$dir).$filename;
}
// 2.1.1: moved repeated logic out of if statements
if ($file && file_exists($file)) {
if ($type == 'file') {$value = $file;}
elseif ($type == 'url') {$value = $url;}
elseif ($type == 'both') {$value = array('file' => $file, 'url' => $url);}
}
}
}
}
}
// --- check template base directory ---
// 2.1.1: combine with child theme check condition to prevent duplicate searches
if (!$value && ($vthemestyledir != $vthemetemplatedir) && in_array('template', $searchroots)) {
$file = $vthemetemplatedir.$filename;
$url = $vthemetemplateurl.$filename;
if (file_exists($file)) {
if ($type == 'file') {$value = $file;}
elseif ($type == 'url') {$value = $url;}
elseif ($type == 'both') {$value = array('file' => $file, 'url' => $url);}
}
}
// --- filter the found file path value ---
// 2.1.0: fix to incorrect filter variable name
// 2.1.1: compressed extra filter values to args array
bioship_debug($filename." Search File Return Value", $value);
$args = array('type' => $type, 'filename' => $filename, 'dirs' => $dirs, 'searchroots' => $searchroots);
$filtered = bioship_apply_filters('theme_file_search', $value, $args);
if ($filtered != $value) {
bioship_debug("Filtered Filepath Search Value", $filtered);
// 2.1.1: added file exists check for filtered value
if (file_exists($filtered)) {$value = $filtered;}
else {bioship_debug("Warning! Filtered Filepath Not Found");}
}
// --- return found file path ---
return $value;
}
}
// -----------------------------
// WordPress.Org Version Checker
// -----------------------------
// note: checks presence of /includes/theme-update-checker.php
// this indicates a version downloaded from Bioship.Space - not from WordPress.org
// 2.0.8: moved this check from admin.php so as to define earlier
// 2.0.9: allow for existing user override for this constant
// 2.1.1: allow for alternative include directory
if (!defined('THEMEWPORG')) {
$themeupdater = bioship_file_hierarchy('file', 'theme-update-checker.php', $vthemedirs['includes']);
// 2.1.0: fix to fallback definition value true for WordPress.Org version
if ($themeupdater) {define('THEMEWPORG', false);}
else {define('THEMEWPORG', true);}
// 2.1.1: set wporg key value on wordquestplugins array
$wordquestplugins[THEMEPREFIX]['wporg'] = THEMEWPORG;
}
// -----------------------
// Get Post Type(s) Helper
// -----------------------
// 1.8.5: added this helper
// 2.0.5: moved here from skull.php
if (!function_exists('bioship_get_post_types')) {
function bioship_get_post_types($queryobject = null) {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__,func_get_args());}
// --- if a numeric value passed, assume it is a post ID ---
if ($queryobject && is_numeric($queryobject)) {$queryobject = get_post($queryobject);}
// --- if an object is passed, assume a post object ---
if ($queryobject && is_object($queryobject)) {
bioship_debug("Queried Object", $queryobject);
return get_post_type($queryobject);
}
// --- standard single post type checks ---
if (is_404()) {return '';} // no post type for a 404
// 1.9.5: removed is_single check - incorrect usage!
// if (is_single()) {return 'post';}
if (is_page()) {return 'page';}
if (is_attachment()) {return 'attachment';}
// 1.9.5: added is_archive check for rare cases
if (is_singular() && !is_archive()) {return get_post_type();}
// --- if a custom query object was not passed, use $wp_query global ---
if (!$queryobject || !is_object($queryobject)) {
global $wp_query; $queryobject = $wp_query;
}
if (!is_object($queryobject)) {return '';}
// --- if the post_type query var has been explicitly set ---
// (or implicitly set on the cpt via a has_archive redirect)
// ie. this is true for is_post_type_archive at least
// $queriedposttype = get_query_var('post_type'); // works for $wp_query only
if (property_exists($queryobject, 'query_vars')) {
$queriedposttype = $queryobject->query_vars['post_type'];
if ($queriedposttype) {return $queriedposttype;}
}
// --- handle all other cases by looping posts in query object ---
$posttypes = array();
if ($queryobject->found_posts > 0) {
$queriedposts = $queryobject->posts;
foreach ($queriedposts as $queriedpost) {
$posttype = $queriedpost->post_type;
if (!in_array($posttype, $posttypes)) {$posttypes[] = $posttype;}
}
if (count($posttypes == 1)) {return $posttypes[0];}
else {return $posttypes;}
}
return '';
}
}
// ---------------------
// Word to Number Helper
// ---------------------
if (!function_exists('bioship_word_to_number')) {
function bioship_word_to_number($word) {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__,func_get_args());}
$wordnumbers = array(
'zero' => '0', 'one' => '1', 'two' => '2', 'three' => '3', 'four' => '4', 'five' => '5', 'six' => '6',
'seven' => '7', 'eight' => '8', 'nine' => '9', 'ten' => '10', 'eleven' => '11', 'twelve' => '12',
'thirteen' => '13', 'fourteen' => '14', 'fifteen' => '15', 'sixteen' => '16',
'seventeen' => '17', 'eighteen' => '18', 'nineteen' => '19', 'twenty' => '20',
'twentyone' => '21', 'twentytwo' => '22', 'twentythree' => '23', 'twentyfour' => '24',
);
// 1.8.5: added check and return false for validation
if (array_key_exists($word, $wordnumbers)) {return $wordnumbers[$word];}
return false;
}
}
// ---------------------
// Number to Word Helper
// ---------------------
if (!function_exists('bioship_number_to_word')) {
function bioship_number_to_word($number) {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__,func_get_args());}
$numberwords = array(
'zero', 'one', 'two', 'three', 'four', 'five', 'six', 'seven', 'eight',
'nine', 'ten', 'eleven', 'twelve', 'thirteen', 'fourteen', 'fifteen', 'sixteen',
'seventeen', 'eighteen', 'nineteen', 'twenty', 'twentyone', 'twentytwo', 'twentythree', 'twentyfour'
);
// 1.8.5: added check and return false for validation
if (array_key_exists($number, $numberwords)) {return $numberwords[$number];}
return false;
}
}
// ---------------------------------
// Load Theme Backwards Compatiblity
// ---------------------------------
// used (sparsely) for any function/filter name changes
// 1.8.5: load theme backwards compatibility file
// 2.0.5: add ability to turn compat.php loading off with a file (as pre-filters)
// 2.1.1: changed file switch name from compat-off.php to compat.off
$compat = bioship_file_hierarchy('file', 'compat.php');
$compatoff = bioship_file_hierarchy('file', 'compat.off');
if ($compat && !$compatoff) {include_once($compat);}
// ------------------
// === Load Theme ===
// ------------------
// ----------------------
// Get Current Theme Data
// ----------------------
// note: pre-3.4 compatibility function loaded in compat.php
$vtheme = wp_get_theme();
// -------------------------------------
// Determine Theme for Test Drive Plugin
// -------------------------------------
// (as Theme Test Drive plugin functions not loaded yet)
if (!function_exists('bioship_themedrive_determine_theme')) {
function bioship_themedrive_determine_theme() {
// --- get internal test drive value if any ---
if (!isset($_REQUEST['theme'])) {
// --- get permission level ---
$tdlevel = get_option('td_level');
if ($tdlevel != '') {$permissions = 'level_'.$tdlevel;}
else {$permissions = 'level_10';}
// --- check permissions ---
if (!current_user_can($permissions)) {return false;}
else {
$tdtheme = get_option('td_themes');
// 2.1.1: added check for false value (unset option)
if (!$tdtheme) {return;}
$tdtheme = trim($tdtheme);
if (empty($tdtheme) || ($tdtheme == '')) {return false;}
}
} else {$tdtheme = $_REQUEST['theme'];}
// --- get test drive theme data
$themedata = wp_get_theme($tdtheme);
// -- loop all themes to match ---
// 2.1.1: simplified theme data check logic
if (empty($themedata)) {
$allthemes = wp_get_themes();
foreach ($allthemes as $themedata) {
if ($themedata['Stylesheet'] == $tdtheme) {break;}
}
}
// --- check for theme data ---
// 2.1.1: simplified theme data check logic
if (!empty($themedata)) {
// note: we are skipping the 'publish' check here - as may be a theme under development
// if (isset($themedata['Status']) && ($themedata['Status'] != 'publish')) {return false;}
return $themedata;
}
return false;
}
}
// ------------------------------
// Theme Test Drive Compatibility
// ------------------------------
// 1.5.0: added check that this is not a theme editor page
// (as theme editor can set a theme key in the querystring
// and this conflicts with a theme test drive parameter)
// TODO: recheck this behaviour on the Customizer page?
global $pagenow;
if ( ($pagenow != 'theme-editor.php') && ($pagenow != 'customize.php') ) {
$themetestdrive = bioship_themedrive_determine_theme();
if ($themetestdrive) {
// --- set theme drive constant ---
define('THEMEDRIVE', true);
$vtheme = $themetestdrive;
// --- set theme directories ---
// 1.8.0: override the style and template directory values
$vthemestyledir = get_stylesheet_directory($vtheme['Stylesheet']).DIRSEP;
$vthemestyleurl = trailingslashit(get_stylesheet_directory_uri($vtheme['Stylesheet']));
$vthemetemplatedir = get_template_directory($vtheme['Template']).DIRSEP;
$vthemetemplateurl = trailingslashit(get_template_directory_uri($vtheme['Template']));
// 1.8.5: re-enforce SSL recheck
if (is_ssl()) {
$vthemestyleurl = str_replace('http://', 'https://', $vthemestyleurl);
$vthemetemplateurl = str_replace('http://', 'https://', $vthemetemplateurl);
}
// --- load Admin Menu Fixes for Theme Test Driving ---
// 2.1.1: added missing function prefix
add_action('admin_menu', 'bioship_admin_themetestdrive_options', 12);
// --- add theme filter for Options Framework ---
// 2.0.1: added missing function prefix
// 2.1.1: adding missing function exists wrapper
// TODO: retest with Options Framework + Customizer combination
// TODO: move to Options Framework integration section ?
if (!function_exists('bioship_optionsframework_themetestdrive')) {
add_filter('of_theme_value', 'bioship_optionsframework_themetestdrive');
function bioship_optionsframework_themetestdrive($theme) {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE,func_get_args());}
$testdrive = bioship_themedrive_determine_theme();
$thetheme['id'] = preg_replace("/\W/", "_", strtolower($testdrive['Name']));
return $theme;
}
}
}
}
// ------------------------------
// Maybe Load Theme Value Filters
// ------------------------------
// check for possible customized filters.php in parent/child theme
// note: *loaded early* as filters are used immediately if present
// 2.0.9: run core directory filter in case override already exists
$vthemedirs['core'] = bioship_apply_filters('theme_core_dirs', $vthemedirs['core']);
$filters = bioship_file_hierarchy('file', 'filters.php', $vthemedirs['core']);
if ($filters) {include_once($filters);}
// ---------------
// Site Icon Check
// ---------------
// 2.0.8: added this to check for global site icon once only
// 2.0.9: make sure function exists and simplify logic (for backwards compatibility)
// 2.1.1: moved down so that any value filters can be loaded and applied
if (!defined('THEMESITEICON')) {
if (function_exists('has_site_icon') && has_site_icon()) {$siteicon = true;} else {$siteicon = false;}
$siteicon = bioship_apply_filters('skeleton_site_icon', $siteicon);
if ($siteicon) {define('THEMESITEICON', $siteicon);} else {define('THEMESITEICON', false);}
}
// ---------------------------
// Filter Resource Directories
// ---------------------------
// 1.8.5: run all the directory search filters here (as may be in filters.php)
$vthemedirs['core'] = bioship_apply_filters('theme_core_dirs', $vthemedirs['core']);
$vthemedirs['admin'] = bioship_apply_filters('theme_admin_dirs', $vthemedirs['admin']);
$vthemedirs['style'] = $vthemedirs['css'] = bioship_apply_filters('theme_style_dirs', $vthemedirs['style']);
$vthemedirs['script'] = $vthemedirs['js'] = bioship_apply_filters('theme_script_dirs', $vthemedirs['script']);
$vthemedirs['image'] = $vthemedirs['img'] = bioship_apply_filters('theme_image_dirs', $vthemedirs['image']);
// 2.0.9: add a single directory array override filter for easier usage
$vthemedirs = bioship_apply_filters('theme_resource_dirs', $vthemedirs);
// --------------------------------------
// Set Global Theme Name and Parent/Child
// --------------------------------------
// 2.0.5: define THEMESLUG (using dashes not underscores)
// 2.0.5: cleaner code logic for child and parent theme constants
$vthemedisplayname = (string)$vtheme['Name'];
define('THEMEDISPLAYNAME', $vthemedisplayname);
$vthemename = preg_replace("/\W/", "-", strtolower($vthemedisplayname));
define('THEMESLUG', $vthemename);
if (!is_child_theme()) {define('THEMECHILD', false); define('THEMEPARENT', false);}
else {define('THEMECHILD', true); define('THEMEPARENT', (string)$vtheme['Template']);}
// -----------------------
// Set Child Theme Version
// -----------------------
// 2.0.1: simplify to set child theme version constant
// 2.0.5: cleaner code logic here
if (!THEMECHILD) {define('THEMECHILDVERSION', THEMEVERSION);}
else {define('THEMECHILDVERSION', $vtheme['Version']);}
// ---------------------------
// Set Theme Debug Mode Switch
// ---------------------------
// 1.8.0: changed this to a constant, allow for switching
// 1.8.5: added all word values and new '3' option
// TODO: maybe move to tracer.php ?
// ?themedebug=0 or ?themedebug=off - switch theme debug mode off
// ?themedebug=1 or ?themedebug=on - switch theme debug mode on (persistant)
// ?themedebug=2 or ?themedebug=yes - debug mode on for this pageload (overrides)
// ?themedebug=3 or ?themedebug=no - debug mode off for this pageload (overrides)
if (!defined('THEMEDEBUG')) {
$vthemekey = preg_replace("/\W/", "_", strtolower($vthemedisplayname));
$themedebug = get_option($vthemekey.'_theme_debug');
if ($themedebug == '1') {$themedebug = true;} else {$themedebug = false;}
if (isset($_REQUEST['themedebug'])) {
$debug = $_REQUEST['themedebug'];
// 1.8.5: authenticate debug capability
// 2.0.9: add filter for debug switching capability
$debugcap = bioship_apply_filters('theme_debug_capability', 'edit_theme_options');
if (current_user_can($debugcap)) {
if ( ($debug == '2') || ($debug == 'yes') ) {
// --- debug on for this pageload only
$themedebug = true;
} elseif ( ($debug == '3') || ($debug == 'no') ) {
// --- debug off for this pageload only ---
$themedebug = false;
} elseif ( ($debug == '1') || ($debug == 'on') ) {
// --- switch theme debug on ---
$themedebug = true; delete_option($vthemekey.'_theme_debug');
add_option($vthemekey.'_theme_debug', '1');
} elseif ( ($debug == '0') || ($debug == 'off') ) {
// --- switch theme debug off ---
$themedebug = false; delete_option($vthemekey.'_theme_debug');
}
}
}
if ( ($themedebug == '') || ($themedebug == '0') ) {$themedebug = false;}
// --- filter debug mode ---
$themedebug = bioship_apply_filters('theme_debug', $themedebug);
// --- finally define debug constant ---
define('THEMEDEBUG', $themedebug);
}
// ----------------------------
// Maybe Start Debug Output/Log
// ----------------------------
// TODO: maybe move this to tracer.php ?
if (THEMEDEBUG) {
global $pagenow; bioship_debug("PageNow", $pagenow);
// 2.0.5: also use save queries constant for debugging output
if (!defined('SAVEQUERIES')) {define('SAVEQUERIES', true);}
if (SAVEQUERIES) {
if (!function_exists('bioship_debug_saved_queries')) {
// 2.1.1: moved add_action internally for consistency
add_action('shutdown', 'bioship_debug_saved_queries');
function bioship_debug_saved_queries() {
global $wpdb; $queries = $wpdb->queries;
bioship_debug("Saved Queries", $queries);
}
}
}
}
// -------------------
// Set Debug Directory
// -------------------
// 1.9.8: set debug directory global value
// 2.1.1: use existing function for this purpose
// if (THEMECHILD) {global $vthemestyledir; $vthemedebugdir = $vthemestyledir.'debug';}
// else {global $vthemetemplatedir; $vthemedebugdir = $vthemetemplatedir.'debug';}
// $vthemedebugdir = bioship_apply_filters('theme_debug_dirpath', $vthemedebugdir);
// if (!is_dir($vthemedebugdir)) {wp_mkdir_p($vthemedebugdir);}
$vthemedebugdir = bioship_check_create_debug_dir();
// -----------------
// Load Theme Tracer
// -----------------
// 1.8.0: moved here as was loaded too early to work, refined logic
if (!defined('THEMETRACE')) {
// --- check for tracer loading ---
// 1.8.5: added querystring option for high capability
$themetracer = false;
if (isset($_REQUEST['themetrace'])) {
$themetracer = $_REQUEST['themetrace'];
if (current_user_can('manage_options')) {
// 2.0.5: make any other value trigger a trace
if ($themetracer != '0') {$themetracer = true;}
}
}
// --- filter tracer loading ---
// 1.9.8: fix to filtered value here
$themetracer = bioship_apply_filters('theme_tracer', $themetracer);
}
// --- Load Theme Tracer ---
// 1.9.8: change fixed directory to admin dir global
$tracer = bioship_file_hierarchy('file', 'tracer.php', $vthemedirs['admin']);
// 2.1.1: moved THEMETRACE definition here from tracer.php (must be below above line!)
if (!defined('THEMETRACE')) {
if ($themetracer) {define('THEMETRACE', true);} else {define('THEMETRACE', false);}
}
if ($tracer) {include($tracer);}
// --- maybe define dummy function ---
// (dummy function to avoid potential fatal errors in edge cases)
if (THEMETRACE && !function_exists('bioship_trace')) {
function bioship_trace($arg1=null, $arg2=null, $arg3=null, $arg4=null) {return;}
}
// -----------------------------------------
// Convert Posted Customizer Preview Options
// -----------------------------------------
// 1.8.5: moved here to be available for both options frameworks
if (!function_exists('bioship_customizer_convert_posted')) {
function bioship_customizer_convert_posted($postedvalues, $optionvalues) {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__,func_get_args());}
global $vthemeoptions;
foreach ($vthemeoptions as $optionkey => $optionvalue) {
// 2.1.1: fix to skip non-options (headings etc)
if (isset($optionvalue['id'])) {
// --- set variable for ID and type ---
$id = $optionvalue['id'];
$type = $optionvalue['type'];
$previewkey = str_replace('_options', '_customize', THEMEKEY.'['.$optionvalue['id'].']');
if (array_key_exists($previewkey, $postedvalues)) {
// --- apply sanitization filters to preview values ---
// 2.1.1.: removed unneeded inline {} wrappers
// note: the third argument above could be a Customizer setting object ?
$previewvalue = bioship_apply_filters('customize_sanitize_'.$previewkey, $postedvalues[$previewkey], array());
// !! WARNING: echoing debug ouput in Customizer prevents saving !!
// (bioship_debug lines are commented out below just in case)
// --- set option value ---
if ($optionvalue['type'] == 'checkbox') {
// 1.8.5: fix for empty checkbox values
if ($previewvalue == '1') {$optionvalues[$id] = '1';}
else {$optionvalues[$id] = '0';}
} else {
if (!is_array($previewvalue)) {
// --- set string value ---
$optionvalues[$id] = $previewvalue;
// bioship_debug("Preview Value for '".$id."'", $previewvalue, false);
} else {
// TODO: maybe do something else for subarray values ?
// bioship_debug("Option Type", $type, false);
// --- Customizer Multicheck values ---
// 1.8.5: fix for customizer multicheck arrays
if ($type == 'multicheck') {
foreach ($optionvalue['options'] as $key => $value) {
if (in_array($key, $previewvalue)) {$valuearray[$key] = '1';}
else {$valuearray[$key] = '0';}
}
$optionvalues[$id] = $valuearray;
} else {
// --- set array value ---
$optionvalues[$id] = $previewvalue;
}
// bioship_debug("Preview Value for '".$id."'", $optionvalues[$id], false);
}
}
}
}
}
return $optionvalues;
}
}
// -------------------------------------------
// Get Theme Settings Filter - with Fallbacks!
// -------------------------------------------
// ...this may seem completely arbitrary and unnecessary but it works...
// 1.9.5: get_option filter to help bypass crazy empty settings / saving bug
// 2.0.9: added theme_settings filter to return value
if (!function_exists('bioship_get_theme_settings')) {
function bioship_get_theme_settings($value, $optionkey = false) {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__);}
global $vthemesettingsfix, $vthemedebugdir;
// --- not while updating settings ---
// 2.1.1: moved this check to update - not get option
// --- check/create debug directory ---
$vthemedebugdir = bioship_check_create_debug_dir();
// --- this is to bypass possible cached value ---
$settings = bioship_get_option(THEMEKEY);
// ---- set to theme key if needed ---
// 1.9.7: fix to missing argument 2 filter warning
if (!$optionkey) {$optionkey = THEMEKEY;}
// --- set found settings flag ---
// 2.1.1: added this for better conditional logic
$foundsettings = false;
// --- unserialize settings check ---
if ($settings) {
if (is_serialized($settings)) {
bioship_debug("Serialized Theme Settings Found");
$settings = (string)$settings;
$unserialized = unserialize($settings);
if ($unserialized) {
// 2.1.1: set as found instead of returning
bioship_debug("Theme Settings Unserialized Successfully");
$settings = $unserialized; $foundsettings = true;
} else {
// and here is the problem (read "ghost insane WTF bug")... finally! yeesh.
// ?!sometimes!? the data JUST DOES NOT UNSERIALIZE - FOR NO CLEAR REASON.
// ...it just returns as false even though the serialized data is there
// and does not appear to be at all corrupt - and works in other contexts!
// --- attempt to fix serialized settings ---
// (but sometimes works sometimes not :-/ )
// $repaired = bioship_fix_serialized($settings);
// $fixedsettings = unserialize($repaired);
// if ($fixedsettings) {return $fixedsettings;}
// --- add theme debug warning ---
if (THEMEDEBUG) {
bioship_debug("WARNING: Unserialization Failed for Option Key", $optionkey);
bioship_debug("Settings", $settings);
bioship_debug("Maybe Unserialized", maybe_unserialize($settings));
bioship_debug("Unserialized", $unserialized);
}
// ---- for now, add a filter so users can apply a custom manual fix ---
// TODO: somehow add an admin warning for when this happens ?
$customsettings = bioship_apply_filters('theme_settings_fallback', $settings);
if (is_serialized($customsettings)) {
$unserialized = @unserialize($customsettings);
if ($unserialized) {
bioship_debug("Unserialized Settings from Custom Override Used");
$settings = $unserialized; $foundsettings = true;
}
}
}
}
}
// --- maybe apply force update settings ---
if (!$foundsettings) {
$forcesettings = get_transient('force_update_'.$optionkey);
if ($forcesettings) {
bioship_debug("Checking Force Update Settings");
if (is_serialized($forcesettings)) {
// --- unserialize force updated settings ---
$unserialized = @unserialize($forcesettings);
if (!$unserialized) {
// --- attempt fix of serialized settings ---
$repaired = bioship_fix_serialized($forcesettings);
$fixedsettings = @unserialize($repaired);
if ($fixedsettings) {
bioship_debug("Fixed Force Update Settings");
$unserialized = $fixedsettings;
}
}
if ($unserialized) {
// --- write to file backup ---
// 2.1.1: use update_option instead of delete and add
// 2.1.1: remove filter to prevent infinite loop
bioship_write_debug_file($optionkey.'.txt', $forcesettings);
remove_filter('pre_option_'.THEMEKEY, 'bioship_get_theme_settings', 10, 2);
update_option($optionkey, $unserialized);
add_filter('pre_option_'.THEMEKEY, 'bioship_get_theme_settings', 10, 2);
// --- add notice for force update settings ---
bioship_debug("Force Update Settings Used and Restored");
// 2.0.0: change to skeleton prefix and add translation wrappers
if (!function_exists('bioship_forced_settings_restored')) {
// 2.1.1: move add_action internally for consistency
add_action('theme_admin_notices', 'bioship_forced_settings_restored');
function bioship_forced_settings_restored() {
echo "".__('Warning','bioship').": ";
echo __('Theme Settings from Force Update Used and Restored!','bioship')."
";
}
}
$settings = $unserialized; $foundsettings = true;
} else {
bioship_debug("Force Update Settings could not be Unserialized");
}
}
}
}
// --- maybe fallback to saved options file ---
if (!$foundsettings) {
// TODO: maybe use file hierarchy for debug directory ?
$savedfile = get_stylesheet_directory().'/debug/'.$optionkey.'.txt';
// bioship_debug("Checking for Backup Settings File", $savedfile);
if (file_exists($savedfile)) {
bioship_debug("Checking Found File Settings");
$saveddata = bioship_file_get_contents($savedfile);
if ((strlen($saveddata) > 0) && is_serialized($saveddata)) {
$unserialized = @unserialize($saveddata);
if (!$unserialized) {
$repaired = bioship_fix_serialized($saveddata);
$fixedsettings = @unserialize($repaired);
if ($fixedsettings) {
bioship_debug("Fixed Serialized File Settings");
$unserialized = $fixedsettings;
$foundsettings = true;
}
}
if ($unserialized) {
// --- update theme settings key ---
// 2.1.1: use update_option instead of delete and add
// 2.1.1: remove option filter to prevent infinite loop
remove_filter('pre_option_'.THEMEKEY, 'bioship_get_theme_settings', 10, 2);
update_option($optionkey, $unserialized);
add_filter('pre_option_'.THEMEKEY, 'bioship_get_theme_settings', 10, 2);
bioship_debug("File Theme Settings Used and Restored");
// 2.0.0: change to skeleton prefix and add translation wrappers
add_action('theme_admin_notices','skeleton_file_settings_restored');
if (!function_exists('bioship_file_settings_restored')) {
function bioship_file_settings_restored() {
echo "".__('Warning','bioship').": ";
echo __('Theme Settings from File Settings Used and Restored!','bioship')."
";
}
}
$settings = $unserialized; $foundsettings = true;
} else {
bioship_debug("File Backup Settings could not be Unserialized");
}
}
}
}
// --- maybe fallback to backup options ---
if (!$foundsettings) {
$backupkey = $optionkey.'_backup';
$backupsettings = bioship_get_option($backupkey);
if ($backupsettings) {
if (is_serialized($backupsettings)) {
$unserialized = unserialize($backupsettings);
if (!$unserialized) {
$repaired = bioship_fix_serialized($backupsettings);
$fixedsettings = unserialize($repaired);
if ($fixedsettings) {
bioship_debug("Fixed AutoBackup Settings");
$unserialized = $fixedsettings;
}
}
if ($unserialized) {
bioship_debug("AutoBackup Settings Used");
if (!$settings) {
// --- set updating flag while updating settings option ---
// 2.1.1: use update_option instead of delete and add
// 2.1.1: remove option filter to prevent infinite loop
remove_filter('pre_option_'.THEMEKEY, 'bioship_get_theme_settings', 10, 2);
update_option($optionkey, $unserialized);
add_filter('pre_option_'.THEMEKEY, 'bioship_get_theme_settings', 10, 2);
bioship_debug("AutoBackup Theme Settings Restored");
// --- add backup restored message ---
// 2.0.0: change to skeleton prefix and add translation wrappers
if (!function_exists('bioship_backup_settings_restored')) {
// 2.1.1: moved add_action internally for consistency
add_action('theme_admin_notices','skeleton_backup_settings_restored');
function bioship_backup_settings_restored() {
echo "".__('Error','bioship').": ";
echo __('Theme Settings Empty! Existing Settings AutoBackup Restored.','bioship')."
";
}
}
}
$settings = $unserialized;
}
}
}
}
bioship_debug("Unserialized Theme Settings Used");
return bioship_apply_filters('theme_settings', $settings);
}
}
// ---------------------
// Serialized Data Fixer
// ---------------------
if (!function_exists('bioship_fix_serialized')) {
function bioship_fix_serialized($string) {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__);}
// --- security ---
if (!preg_match('/^[aOs]:/', $string)) {return $string;}
if (@unserialize($string) !== false) {return $string;}
$string = preg_replace("%\n%", "", $string);
// --- doublequote exploding ---
$data = preg_replace('%";%', "µµµ", $string);
$tab = explode("µµµ", $data);
$newdata = '';
foreach ($tab as $line) {
$newdata .= preg_replace_callback('%\bs:(\d+):"(.*)%', 'bioship_fix_str_length', $line);
}
return $newdata;
}
}
// ------------------------------
// Fix Serialized String Callback
// ------------------------------
if (!function_exists('bioship_fix_str_length')) {
function bioship_fix_str_length($matches) {
$string = $matches[2];
// yes, strlen even for UTF-8 characters
// PHP wants the mem size, not the char count
$rightlength = strlen($string);
$corrected = 's:'.$rightlength.':"'.$string.'";';
return $corrected;
}
}
// --------------------------------------------
// Check / Fix Updated Theme Settings (PreSave)
// --------------------------------------------
// 2.1.0: use pre-filtering of option value instead of do_action hook
if (!function_exists('bioship_admin_theme_settings_save')) {
// 2.1.1: moved add_filter internally for consistency
add_filter('pre_update_option', 'bioship_admin_theme_settings_save', 11, 3);
function bioship_admin_theme_settings_save($newsettings, $option, $oldsettings) {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__,func_get_args());}
global $vthemedebugdir, $vthemesettingsfix, $vthemename;
// --- check settings update conditions ---
if ($option != THEMEKEY) {return $newsettings;}
if ($vthemesettingsfix) {return $newsettings;}
if (defined('THEMEUPDATED') && THEMEUPDATED) {return $newsettings;}
// --- store the setings value ---
// 2.0.9: store the serialized settings value
// 2.1.0: changed to use the unserialized settings value due to filter
$settings = maybe_unserialize($newsettings);
// --- get posted multicheck settings ---
// 2.0.9: for auto-fixing of multicheck theme option saving
// 2.1.1: fix undefined variable warning for postedmulticheck
$multicheckkeys = $postedmulticheck = array();
$multicheckoptions = get_option($vthemename.'_multicheck_options');
$multicheckkeys = array_keys($multicheckoptions);
foreach ($multicheckkeys as $key) {
if (isset($_POST[$vthemename.'_'.$key])) {$postedmulticheck[$key] = $_POST[$vthemename.'_'.$key];}
}
// --- unserialize old and new settings ---
$oldsettings = maybe_unserialize($oldsettings);
$newsettings = maybe_unserialize($newsettings);
$newsettingskeys = array_keys($newsettings);
// --- get new multicheck settings ---
foreach ($newsettings as $key => $value) {
if (in_array($key, $multicheckkeys)) {$newmulticheck[$key] = maybe_unserialize($value);}
}
// --- maybe get old multicheck settings ---
// 2.1.0: can only use old settings as fallbacks if they unserialized correctly
if (is_array($oldsettings)) {
$oldsettingskeys = array_keys($oldsettings);
foreach ($oldsettings as $key => $value) {
if (in_array($key, $multicheckkeys)) {$oldmulticheck[$key] = maybe_unserialize($value);}
}
}
// --- fix if new multicheck settings are not set ---
// 2.1.0: finally, use posted or old multicheck settings if the new ones are empty!
foreach ($newmulticheck as $key => $values) {
if (!isset($settings[$key]) || empty($settings[$key])) {
if (isset($_POST[$vthemename.'_'.$key]) && !empty($_POST[$vthemename.'_'.$key])) {
// 2.1.1: fix to variable typo for key
$settings[$key] = $_POST[$vthemename.'_'.$key];
} elseif (isset($oldmulticheck[$key]) && !empty($oldmulticheck[$key])) {
$settings[$key] = $oldmulticheck[$key];
}
}
}
// --- get settings save debug data ---
// 2.1.0: for debugging multicheck option saving (THE super annoying bug)
$vthemedebugdir = bioship_check_create_debug_dir();
$debugdata = ''.PHP_EOL;
// $debugdata .= ''.print_r($_GET, true).PHP_EOL;
// $debugdata .= ''.print_r($_POST, true).PHP_EOL;
// $debugdata .= ''.print_r($multicheckoptions, true).PHP_EOL;
$debugdata .= ''.print_r($multicheckkeys, true).PHP_EOL;
$debugdata .= ''.print_r($postedmulticheck,true).PHP_EOL;
// $debugdata .= ''.print_r($oldsettings, true).PHP_EOL;
// $debugdata .= ''.print_r($newsettings, true).PHP_EOL;
// $debugdata .= ''.print_r($oldsettingskeys, true).PHP_EOL;
// $debugdata .= ''.print_r($newsettingskeys, true).PHP_EOL;
$debugdata .= ''.print_r($oldmulticheck, true).PHP_EOL;
$debugdata .= ''.print_r($newmulticheck, true).PHP_EOL;
$debugdata .= ''.print_r($settings, true).PHP_EOL;
// echo $debugdata;
// --- maybe write debug data ---
if (THEMEDEBUG) {
$debugfile = $vthemedebugdir.'/multicheck-options.txt';
$debugdata = str_replace('', ': ', $debugdata);
// 2.1.0: use plain error_log function here
// 2.1.1: reverted to use internal write function
bioship_write_to_file($debugfile, $debugdata, true);
}
// --- write settings to file backup ---
// 2.1.0: reserialize the settings to ensure update
if ($settings && !empty($settings) && is_array($settings)) {
$serialized = serialize($settings);
// write a manual settings file backup of the serialized data
// 1.8.0: use standalone debug file write function
// 2.1.1: set new append argument to false here
bioship_write_debug_file($option.'.txt', $serialized, false);
// --- set new settings transient to ensure saving ---
set_transient('force_update_'.THEMEKEY, $settings, 60);
if (!defined('THEMEUPDATED')) {define('THEMEUPDATED', true);}
return $settings;
}
return $newsettings;
}
}
// ----------------------------
// Debug Updated Theme Settings
// ----------------------------
// 2.1.1: added missing function exists wrapper
if (!function_exists('bioship_check_updated_option')) {
add_action('updated_option', 'bioship_check_updated_option', 10, 3);
function bioship_check_updated_option($option, $oldvalue, $value) {
if ($option == THEMEKEY) {
echo "";
$settings = get_option(THEMEKEY);
echo "";
}
}
}
// --------------------------------------
// On/Off File Switch for Titan Framework
// --------------------------------------
// 1.8.5: convert previous version file switches
// Usage Note: creating a titanswitch.off file will revert to Options Framework usage,
// and creating a titanswitch.on file will remove Options Framework usage...
if (THEMECHILD) {$titanoff = $titanon = $vthemestyledir;}
else {$titanoff = $titanon = $vthemetemplatedir;}
$titanoff .= 'titanswitch.off'; $titanon .= 'titanswitch.on';
if (file_exists($titanoff)) {add_option($vthemename.'_framework', 'options'); unlink($titanoff);}
elseif (file_exists($titanon)) {delete_option($vthemename.'_framework'); unlink($titanon);}
// ---------------------------
// Check for Framework to Load
// ---------------------------
// note: if Titan is present it is loaded, otherwise things should still run okay...
// 1.8.5: new method to check switch for Options Framework usage
$vthemeframework = get_option($vthemename.'_framework');
if ($vthemeframework == 'options') {$optionsload = true; $titanload = false;}
else {$optionsload = false; $titanload = true;}
// --- default load, loads Titan if present ---
if (!$optionsload) {
// maybe Load Titan Framework
// --------------------------
// note: hyphenated theme names eg. my-child-theme
// --- set theme settings key ---
if (!defined('THEMEKEY')) {define('THEMEKEY', $vthemename.'_options');}
// --- check for Titan Framework plugin ---
// 1.8.0: do a check as Titan may already active as a plugin
// note: the TitanFramework class itself is loaded after_theme_setup (so not available yet)
// 1.8.5: maybe use the already loaded Titan Framework plugin
if (class_exists('TitanFrameworkPlugin')) {define('THEMETITAN', true);}
else {
// --- set Titan directories ---
// 2.1.1: allow for alternative includes directory
$titandirs = array('titan');
if (count($vthemedirs['includes']) > 0) {
foreach ($vthemedirs['includes'] as $dir) {$titandirs[] = $dir.DIRSEP.'titan';}
}
// --- Titan Framework embedder ---
$titan = false;
if ($titanload) {
// --- locate Titan Framework embedder ---
$titan = bioship_file_hierarchy('file', 'titan-framework-embedder.php', $titandirs);
// --- load Titan Framework embedder ---
if ($titan) {require_once($titan); define('THEMETITAN', true);}
}
if (!$titanload || !$titan) {
// --- load for Titan Framwork checker ---
// note: lack of Titan Framework embedder indicates it was not found
// - probably this indicates it is a WordPress.Org version of the theme
// 2.0.9: changed Titan checker setting to required=false for wordpress.org version
// 2.0.9: moved Theme Tools submenu loading to admin.php
// 2.1.1: allow for alternative includes directory
$titandirs = array_merge($vthemedirs['includes'], $titandirs);
$titanchecker = bioship_file_hierarchy('file', 'titan-framework-checker.php', $dirs);
if ($titanchecker) {require_once($titanchecker);}
else {bioship_debug("Warning! Titan Framework Checker not found.");}
}
}
} else {
// maybe Load Options Framework
// ----------------------------
// --- set theme settings key ---
// note: underscored theme names eg. my_child_theme
$vthemename = str_replace('-', '_', $vthemename);
if (!defined('THEMEKEY')) {define('THEMEKEY', $vthemename);}
// 1.9.5: add filter to get theme settings with fallback
add_filter('pre_option_'.THEMEKEY, 'bioship_get_theme_settings', 10, 2);
// --- set Options Framework directories ---
// 1.8.0: use file hierarchy search here
// 2.1.1: allow for an alternative includes directory
$optionsdirs = array('options');
if (count($vthemedirs['includes']) > 0) {
foreach ($vthemedirs['includes'] as $dir) {$optionsdirs[] = $dir.DIRSEP.'options';}
}
// --- find and load Options Framework ---
$optionsframework = bioship_file_hierarchy('file', 'options-framework.php', $optionsdirs);
if ($optionsframework) {
$optionspath = dirname($optionsframework).DIRSEP;
define('OPTIONS_FRAMEWORK_DIRECTORY', $optionspath);
require_once($optionsframework);
// 1.8.5: define constant for Options Framework
define('THEMEOPT', true);
} else {define('THEMEOPT', false);}
// --- load Theme Options array ---
// 1.8.5: fix - load the theme options array here!
$optionsframework = bioship_file_hierarchy('file', 'options.php');
if ($optionsframework) {include($optionsframework);}
else {wp_die(__('Uh oh, the required Theme Option definitions are missing! Reinstall?!','bioship'));}
// --- get all Theme Options ---
global $vthemeoptions;
$vthemeoptions = bioship_options();
// --- get Options Framework theme settings ---
$vthemesettings = get_option(THEMEKEY);
// --- Auto Backup of Theme Settings
// 1.9.5: moved here for better checking
if ($vthemesettings && !empty($vthemesettings) && ($vthemesettings != '') && is_array($vthemesettings)) {
$backupkey = THEMEKEY.'_backup'; update_option($backupkey, $vthemesettings);
}
// Customizer Live Preview Values
// ------------------------------
// TODO: retest with Options Framework + Customizer combo!
global $pagenow;
if (is_customize_preview() && ($pagenow != 'customizer.php')) {
// !!! WARNING: DEBUG OUTPUT IN CUSTOMIZER CAN PREVENT SAVING !!!
if (isset($_POST['customized'])) {$postedvalues = json_decode(wp_unslash($_POST['customized']), true);}
if (!empty($postedvalues)) {
// TODO: check theme options override with preview options ?
// 1.9.5: fix to ridiculous typo bug here "(", not ".)"
$vthemesettings = bioship_customizer_convert_posted($postedvalues, $vthemesettings);
}
}
// TODO: test/fix for empty checkbox/multicheck values ?
// note: seems to be working fine now though
}
// ----------------------------
// Set Framework Flag Constants
// ----------------------------
// 1.8.5: set framework constants to false if not loaded
if (!defined('THEMETITAN')) {define('THEMETITAN', false);}
if (!defined('THEMEOPT')) {define('THEMEOPT', false);}
if (!THEMETITAN) {bioship_debug("Titan Framework is OFF");}
if (!THEMEOPT) {bioship_debug("Options Framework is OFF");}
// -----------------------------------------
// Map Titan Option values to Theme Settings
// -----------------------------------------
// 1.8.0: move because of function_exists wrapper this needs to be *here* not later
// 1.8.5: use optionsarray global and made single argument only
if (!function_exists('bioship_titan_theme_options')) {
function bioship_titan_theme_options($optionvalues) {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__,func_get_args());}
global $vthemeoptions, $vthemename;
// --- loop the options array and convert to Theme Settings ---
$checkboxes = $multicheck = array();
foreach ($vthemeoptions as $option => $optionvalue) {
// --- check type and skip headings/info ---
if ( ($optionvalue['type'] != 'heading') && ($optionvalue['type'] != 'info') ) {
// --- use option ID for key ---
if (!isset($optionvalue['id'])) {
bioship_debug("Option definition error found!", $optionvalue);
} else {$optionkey = $optionvalue['id'];}
// --- set to default for any unset options ---
if (!isset($optionvalues[$optionkey])) {
// 1.9.8: fix to mapping of default options for empty settings
if (isset($optionvalue['std'])) {$vthemesettings[$optionkey] = $optionvalue['std'];}
}
// --- fix for serialized suboption values ---
if (isset($optionvalues[$optionkey])) {
$vthemesettings[$optionkey] = maybe_unserialize($optionvalues[$optionkey]);
}
// --- fix for empty checkbox values ---
// 1.8.5: added this checkbox value fix
if ($optionvalue['type'] == 'checkbox') {
// 1.9.5: fix to undefined index warning (typically for new settings)
if (isset($optionvalues[$optionkey]) && ($optionvalues[$optionkey] != '1')) {
$vthemesettings[$optionkey] = '0';
}
}
// --- fix for multicheck array options ---
// 1.8.5: redo fix for multicheck options
if ($optionvalue['type'] == 'multicheck') {
// --- check option key is set ---
// 1.9.5: fix to undefined index (typically for new settings)
if (isset($optionvalues[$optionkey])) {
$optionvalues[$optionkey] = maybe_unserialize($optionvalues[$optionkey]);
} else {$optionvalues[$optionkey] = array();}
// bioship_debug("Option Values", $optionvalues[$optionkey]);
// --- set option value array ---
$optionarray = array();
// 2.0.9: fix for standalone multicheck customizer control saving
if (is_string($optionvalues[$optionkey])) {
if (strstr($optionvalues[$optionkey], ',')) {
$optionvalues[$optionkey] = explode(',', $optionvalues[$optionkey]);
} else {$optionvalues[$optionkey] = array($optionvalues[$optionkey]);}
}
// --- loop multicheck options ---
foreach ($optionvalue['options'] as $key => $label) {
$multicheck[$optionkey][] = $key;
// if (THEMEDEBUG) {echo "";}
// 1.9.9: fix to arrays switching around weirdly
// 2.1.0: add check for if optionvalues is an array
if (is_array($optionvalues[$optionkey])) {
if (array_key_exists($key, $optionvalues[$optionkey])) {
// 2.0.0: one more fix for this absolute madness!
// bioship_debug("!A!", $optionvalues[$optionkey][$key]);
if ($optionvalues[$optionkey][$key] == '0') {$optionarray[$key] = '0';}
else {$optionarray[$key] = '1';}
} elseif (in_array($key, $optionvalues[$optionkey])) {
// bioship_debug("!B!", $optionvalues[$optionkey][$key]);
$optionarray[$key] = '1';
} else {$optionarray[$key] = '0';}
} else {$optionarray[$key] = '0';}
}
// ! WARNING: uncommenting this debug line may prevent Customizer saving !
bioship_debug("Option Array for '".$optionkey."'", $optionarray, false, true);
$vthemesettings[$optionkey] = $optionarray;
}
// --- convert attachment IDs to actual image URL ---
if ($optionvalue['type'] == 'upload') {
// 1.9.8: add check for empty options to avoid warning
if (isset($vthemesettings[$optionkey]) && is_numeric($vthemesettings[$optionkey])) {
$image = wp_get_attachment_image_src($vthemesettings[$optionkey], 'full');
$vthemesettings[$optionkey] = $image[0];
}
}
}
}
// --- reset the multicheck options index ---
// 2.1.1: just use update_option instead of delete and add
update_option($vthemename.'_multicheck_options', $multicheck);
return $vthemesettings;
}
}
// -------------------------------
// Load Theme Options and Settings
// -------------------------------
// 1.8.0: load options.php (if not already using Options Framework)
// 1.9.5: moved settings transfers to admin.php
// note: converts all options whether Titan Framework is loaded or not
if (!THEMEOPT) {
// --- set theme settings key ---
// 2.0.5: simplify to use THEMESLUG here
$vthemename = THEMESLUG;
if (!defined('THEMEKEY')) {define(THEMEKEY, $vthemename.'_options');}
// 1.9.5: add filter to get theme settings with fallback
add_filter('pre_option_'.THEMEKEY, 'bioship_get_theme_settings', 10, 2);
// --- load the theme options array ---
$options = bioship_file_hierarchy('file', 'options.php');
if ($options) {include($options);}
else {wp_die(__('Uh oh, the required Theme Option definitions are missing! Reinstall?!','bioship'));}
// 1.9.5: fix for when transferred options manually ?
// if (!function_exists('bioship_titan_no_options_fix')) {
// add_filter('tf_init_no_options_'.THEMEKEY, 'bioship_titan_no_options_fix');
// function bioship_titan_no_options_fix() {return maybe_unserialize(get_option(THEMEKEY));}
// }
// --- to initialize the Titan Framework admin page ---
if (!function_exists('bioship_titan_create_options')) {
add_action('tf_create_options', 'bioship_titan_create_options');
function bioship_titan_create_options() {$loadtitan = bioship_optionsframework_to_titan();}
}
// --- load options array ---
// note: whether Titan class available or not
global $vthemeoptions;
$vthemeoptions = bioship_options();
$settings = maybe_unserialize(get_option(THEMEKEY));
bioship_debug("Titan Framework Settings", $settings);
$optionvalues = maybe_unserialize($settings);
// Customizer Live Preview Values
// ------------------------------
// 1.8.5: fix for Customizer transport refresh method
// check for the posted preview values manually as Customizer is failing to do this for us!
// TODO: check if this is needed with Options Framework + Customizer combination
// note: http://badfunproductions.com/use-is_customize_preview-and-not-is_admin-with-theme-customization-api/
global $pagenow;
if (is_customize_preview() && ($pagenow != 'customize.php')) {
// ! WARNING: Debug output in Customizer can prevent saving !
// bioship_debug("Customize Preview Theme Options");
if (isset($_POST['customized'])) {$postedvalues = json_decode(wp_unslash($_POST['customized']), true);}
if (!empty($postedvalues)) {
// bioship_debug("Posted Preview Values", $postedvalues);
$optionvalues = bioship_customizer_convert_posted($postedvalues, $optionvalues);
// bioship_debug("Full Preview Options", $optionvalues);
}
}
// --- get Theme Settings ---
$vthemesettings = bioship_titan_theme_options($optionvalues);
// to manually debug all theme options / values
// bioship_debug("THEMEKEY", THEMEKEY);
// bioship_debug("Theme Options", $vthemeoptions);
// bioship_debug("Option Values", $optionvalues);
// bioship_debug("Theme Settings", $vthemesettings);
// --- AutoBackup Theme Settings ---
// 1.9.5: moved here for better checking placement
// 2.1.1: just use update_option instead of delete and add
if ($optionvalues && !empty($optionvalues) && ($optionvalues != '') && is_array($optionvalues)) {
$backupkey = THEMEKEY.'_backup'; update_option($backupkey, $vthemesettings);
}
}
// --------------------------
// Load Theme Admin Functions
// --------------------------
// 2.1.1: simplified admin loading conditional logic
if (is_admin()) {$loadadmin = true;} else {$loadadmin = false;}
// 1.9.5: also load if requesting theme dump output
if ( ($vthemesettings == '') || (isset($_REQUEST['themedump'])) ) {$loadadmin = true;}
// 1.8.0: allow for backup/restore/import/export/revert theme options AJAX requests
if (isset($_REQUEST['action']) && strstr($_REQUEST['action'], '_theme_options')) {$loadadmin = true;}
if ($loadadmin) {
$themeadmin = bioship_file_hierarchy('file', 'admin.php', $vthemedirs['admin']);
if ($themeadmin) {include($themeadmin);}
}
// --------------------------
// Set HTML Comments Constant
// --------------------------
if (!defined('THEMECOMMENTS')) {
$htmlcomments = false;
$htmlcomments = true;
if ( (isset($vthemesettings['htmlcomments'])) && ($vthemesettings['htmlcomments'] == '1') ) {$htmlcomments = true;}
$htmlcomments = bioship_apply_filters('skeleton_html_comments', $htmlcomments);
define('THEMECOMMENTS', $htmlcomments);
}
// -------------------
// Output HTML Comment
// -------------------
// 2.0.8: new function to reduce comment code clutter in templates
// 2.1.1: added second argument for output or return
if (!function_exists('bioship_html_comment')) {
function bioship_html_comment($comment, $output = true) {
if (!defined('THEMECOMMENTS') || !THEMECOMMENTS) {return '';}
// --- output HTML comment ---
$output = "".PHP_EOL;
// 2.1.1: added handling echo or return
if ($output) {echo $output;} else {return $output;}
}
}
// ---------------------------
// Set Javascript Cachebusting
// ---------------------------
global $vjscachebust; $cachebust = $vthemesettings['javascriptcachebusting'];
// 1.9.5: clear stat cache for filemtime cachebusting
if ( ($cachebust == 'yearmonthdate') || ($cachebust == '') ) {$vjscachebust = date('ymd').'0000';}
elseif ($cachebust == 'yearmonthdatehour') {$vjscachebust = date('ymdH').'00';}
elseif ($cachebust == 'datehourminutes') {$vjscachebust = date('ymdHi');}
elseif ($cachebust == 'themeversion') {$vjscachebust = THEMEVERSION;}
elseif ($cachebust == 'childversion') {$vjscachebust = THEMECHILDVERSION;}
elseif ($cachebust == 'filemtime') {clearstatcache();}
// ----------------------------
// Set Stylesheet Cachebusting
// ----------------------------
global $vcsscachebust; $cachebust = $vthemesettings['stylesheetcachebusting'];
// 1.9.5: clear stat cache for filemtime cachebusting
if ( ($cachebust == 'yearmonthdate') || ($cachebust == '') ) {$vcsscachebust = date('ymd').'0000';}
elseif ($cachebust == 'yearmonthdatehour') {$vcsscachebust = date('ymdH').'00';}
elseif ($cachebust == 'datehourminutes') {$vcsscachebust = date('ymdHi');}
elseif ($cachebust == 'themeversion') {$vcsscachebust = THEMEVERSION;}
elseif ($cachebust == 'childversion') {$vcsscachebust = THEMECHILDVERSION;}
elseif ($cachebust == 'filemtime') {clearstatcache();}
// ---------------------------
// Declare WooCommerce Support
// ---------------------------
// ref: http://docs.woothemes.com/document/third-party-custom-theme-compatibility/
// WARNING: Do NOT create a woocommerce.php page template for your theme!
// This is a 'beginner mistake' as it prevents you from overriding default templates
// such as single-product.php and archive-product.php later (see class-wc-template-loader.php)
// TODO: test whether default to true has any negative effects
$woosupport = bioship_apply_filters('skeleton_declare_woocommerce_support', true);
if ($woosupport) {add_theme_support('woocommerce');}
else {
// --- remove no support notice ---
// 1.8.0: auto-remove the 'this theme does not declare WooCommerce support' notice
// (as this theme does support WooCommerce whether it is flagged or not)
if (!function_exists('bioship_remove_woocommerce_theme_notice')) {
add_action('admin_notices', 'bioship_remove_woocommerce_theme_notice');
function bioship_remove_woocommerce_theme_notice() {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__);}
// 2.1.1: moved class exists check internally
if (!class_exists('WC_Admin_Notices')) {return;}
// --- maybe remove admin notice ---
$notices = array_diff(get_option('woocommerce_admin_notices', array()), array('theme_support'));
update_option('woocommerce_admin_notices', $notices);
}
}
}
// ------------------------------
// Set Post Format Theme Supports
// ------------------------------
// note: need to declare this support before loading Hybrid Core
if ($vthemesettings['postformatsupport'] == '1') {
$i = 0; $postformatsupport = array();
// --- filter post format support ---
// 2.0.9: added missing filter for this theme setting
$postformats = bioship_apply_filters('skeleton_post_format_support', $vthemesettings['postformats']);
// --- add theme support for post formats ---
// 2.1.1: added post format array check
if (is_array($postformats) && (count($postformats) > 0)) {
foreach ($postformats as $postformat => $value) {
if ($value == '1') {$postformatsupport[$i] = $postformat; $i++;}
}
if (count($postformatsupport) > 0) {
add_theme_support('post-formats', $postformatsupport);
}
}
}
// -----------------------------
// maybe Output Theme Debug Info
// -----------------------------
if (THEMEDEBUG) {
// 2.0.9: converted to bioship_debug calls
if (defined('THEMEDRIVE') && THEMEDRIVE) {bioship_debug("Theme Test Drive is ACTIVE");}
bioship_debug("Stylesheet Dir", $vthemestyledir);
bioship_debug("Stylesheet URL", $vthemestyleurl);
bioship_debug("Theme Template Dir", $vthemetemplatedir);
bioship_debug("Theme Template URL", $vthemetemplateurl);
bioship_debug("Active Theme Object", $vtheme);
bioship_debug("Sidebars/Widgets", get_option('sidebars_widgets'));
bioship_debug("Nav Menu Settings", get_option('nav_menu_options'));
bioship_debug("Theme Mods", get_option('theme_mods_'.str_replace('_','-',$vthemename)));
bioship_debug("Theme Options (".THEMEKEY.")", $vthemesettings);
}
// ------------------
// === CUSTOMIZER ===
// ------------------
// -----------------
// Customizer Loader
// -----------------
// 1.8.0: conditionally load Customizer options via customizer.php
if (!function_exists('bioship_customizer_loader')) {
// 2.0.9: changed to earlier loading action (for Kirki 3)
add_action('after_setup_theme', 'bioship_customizer_loader', 5);
function bioship_customizer_loader($previewwindow = false) {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__);}
if (function_exists('bioship_customizer_preview')) {return true;}
// --- check conditions ---
// 2.0.9: check conditions if not in preview window
if (!$previewwindow) {
if (!is_admin() || !is_user_logged_in()) {return false;}
if (!current_user_can('edit_theme_options')) {return false;}
}
// --- load admin Customizer integration ---
global $vthemedirs;
$customizer = bioship_file_hierarchy('file', 'customizer.php', $vthemedirs['admin']);
if ($customizer) {
include_once($customizer);
// --- load Kirki libary ---
// 2.0.9: maybe initialize Kirki library now
// 2.1.1: moved inside customizer loaded check
bioship_kirki_loader();
}
// --- return whether loaded ---
if ($customizer) {return true;} else {return false;}
}
}
// ------------------------
// Load Customizer Controls
// ------------------------
if (!function_exists('bioship_customizer_init')) {
add_action('customize_register', 'bioship_customizer_init');
function bioship_customizer_init($wp_customize) {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__,func_get_args());}
remove_action('customize_register', 'bioship_customizer_init');
// --- load Customizer ---
// 2.0.9: load Customizer functions for the preview window
$loaded = bioship_customizer_loader();
if (!$loaded) {return;}
// --- register and load Customizer controls ---
bioship_customizer_register_controls($wp_customize);
bioship_customizer_load_control_options($wp_customize);
// --- load Customizer scripts in footer ---
add_action('customize_controls_print_footer_scripts', 'bioship_customizer_text_script');
}
}
// -------------------------
// Customizer Preview Window
// -------------------------
// note: controls do not need to be registered for preview window
if (!function_exists('bioship_customizer_preview_loader')) {
add_action('customize_preview_init', 'bioship_customizer_preview_loader');
function bioship_customizer_preview_loader() {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__);}
$loaded = bioship_customizer_loader(true);
if (!$loaded) {return;}
// --- register and load Customizer controls ---
// 2.0.9: make sure to register and load controls in preview window
// (otherwise active states are not set and controls, panels and sections disappear!)
global $wp_customize;
bioship_customizer_register_controls($wp_customize);
bioship_customizer_load_control_options($wp_customize);
// --- load the Customizer Preview scripts ---
add_action('wp_footer', 'bioship_customizer_preview', 21);
}
}
// ------------------------
// Customizer Loading Image
// ------------------------
// 1.8.5: added Kirki preview loading image override
// 1.9.5: moved this to Customizer Section from stylesheet loading
global $pagenow;
if (is_customize_preview() && ($pagenow != 'customize.php')) {
if (!function_exists('bioship_customizer_loading_icon')) {
add_action('wp_head', 'bioship_customizer_loading_icon');
function bioship_customizer_loading_icon() {
// 1.8.5: use bioship loading image
global $vthemedirs;
$loadingimage = bioship_file_hierarchy('url', 'customizer-loading.png', $vthemedirs['image']);
if ($loadingimage) {
echo "";
}
}
}
}
// -------------------
// === HYBRID CORE ===
// -------------------
// 2.1.1: removed old vhybrid global (no longer used)
// 2.1.1: use simplified valid load values check
$loadhybrid = $vthemesettings['hybridloadcore'];
$valid = array('1', '2', '3');
if (in_array($loadhybrid, $valid)) {
// --- set Hybrid Core flag ---
// 2.1.1: removed old vhybrid global (no longer used)
define('THEMEHYBRID', true);
// --- set Hybrid Core directories ---
// 1.8.0: set hybrid core library version to use
// note: value 1 or 2 = HC2 (as previously a checkbox), value 3 = HC3
if ( ($loadhybrid == '1') || ($loadhybrid == '2') ) {$hybridversion = '2';}
elseif ($loadhybrid == '3') {$hybridversion= '3';}
// 2.1.1: loop to allow for alternative includes directories
$hybriddirs = array();
if (count($vthemedirs['includes']) > 0) {
// --- set directories
if ($hybridversion == '2') {
foreach ($vthemedirs['includes'] as $dir) {$hybriddirs[] = $dir.DIRSEP.'hybrid2';}
}
// 2.0.9: also fallback for HC2 to HC3 (in case HC2 removed/deprecated)
foreach ($vthemedirs['includes'] as $dir) {$hybriddirs[] = $dir.DIRSEP.'hybrid3';}
}
// 2.0.9: filter the Hybrid directory search paths
$hybriddirs = bioship_apply_filters('hybrid_dirs', $hybriddirs);
// --- set Hybrid Core paths ---
// (note: if loading Hybrid from Child Theme, ALL of Hybrid Core must be there - not just hybrid.php!)
// 2.0.9: use file hierarchy to find Hybrid file path
$hybridpath = bioship_file_hierarchy('file', 'hybrid.php', $hybriddirs);
if (!$hybridpath) {wp_die(__('Uh oh, the required Hybrid Core Framework is missing!','bioship'));}
$hybriddir = trailingslashit(dirname($hybridpath));
define('HYBRID_DIR', $hybriddir);
// initialize Hybrid Core
// ----------------------
require_once($hybridpath);
new Hybrid();
// Hybrid Core Setup
// -----------------
if (!function_exists('bioship_hybrid_core_setup')) {
// 2.1.1: moved add_action internally for consistency
add_action('after_setup_theme', 'bioship_hybrid_core_setup', 11);
function bioship_hybrid_core_setup() {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__);}
global $vthemesettings;
// Hybrid Core Setup
// -----------------
// --- Add Custom Template Hierarchy ---
// note: !*required*!
add_theme_support('hybrid-core-template-hierarchy');
// --- Backwards Compatibility ---
// 1.8.0: added for HC3 (I like backwards compatibility)
add_theme_support('hybrid-core-deprecated');
// note: unuse Hybrid Core Theme Layout and Settings
// add_theme_support('theme-layouts');
// add_theme_support('hybrid-core-theme-settings');
// Hybrid Extensions
// -----------------
// --- Get The Image ---
// "The best thumbnail/image script ever"
if ($vthemesettings['hybridthumbnails'] == '1') {add_theme_support('get-the-image');}
// --- Hybrid Breadcrumbs ---
if ($vthemesettings['hybridbreadcrumbs'] == '1') {add_theme_support('breadcrumb-trail');}
// --- Nicer [gallery] shortcode styles ---
if ($vthemesettings['hybridgallery'] == '1') {add_theme_support('cleaner-gallery');}
// ...the rest of these were mostly just for Hybrid 2...
// - Hybrid Shortcodes
// deactivated shortcodes for now... is this even in HC3?
// if ($vthemesettings['hybridshortcodes'] == '1') {add_theme_support('hybrid-core-shortcodes');}
// --- Pagination ---
// 1.8.0: removed in Hybrid Core v3
// if ($vthemesettings['hybridpagination'] == '1') {add_theme_support('loop-pagination');}
// --- Better captions for themes to style ---
// note: removed in Hybrid Core v3
// if ($vthemesettings['hybridcaptions'] == '1') {add_theme_support('cleaner-caption');}
// --- Per Page Featured Header image --- (removed as custom_header no longer used)
// if ($vthemesettings['hybridfeaturedheaders'] == '1') {add_theme_support('featured-header');}
// --- Random Custom Background ---
// note: removed in Hybrid Core v3
// if ($vthemesettings['hybridrandombackground'] == '1') {add_theme_support('random-custom-background');}
// --- Per Post Stylesheets ---
// 1.5.0: removed as handled by theme metabox
// if ($vthemesettings['hybridpoststylesheets'] == '1') {add_theme_support('post-stylesheets');}
// --- backwards compatibility images fix ---
// 1.3.5: WP < 3.9 Fix: remove hybrid_image_size_names_choose (media.php) // >
// causing editor footer scripts to crash prior to 3.9 (to support WP 3.4+)
// (avoids fatal error: has_image_size function does not exist)
global $wp_version;
if (version_compare($wp_version,'3.9','<')) { //'>
remove_filter('image_size_names_choose', 'hybrid_image_size_names_choose');
}
// --- remove the Hybrid Title Action ---
// (Fix for Hybrid 2)
// 2.0.5: check action is hooked before removing
// 2.0.8: revert to not check action as preventing removal
remove_action('wp_head', 'hybrid_doctitle', 0);
}
}
} else {
// Non-Hybrid Fallback Loading
// ---------------------------
// --- set Hybrid flag ---
// 1.8.0: set constant flag for non-Hybrid
// 2.1.1: removed old vhybrid constant (no longer used)
define('THEMEHYBRID', false);
// --- HTML5 Theme Supports ---
// 2.0.5: add HTML5 support without Hybrid
add_theme_support('html5', array('caption', 'comment-form', 'comment-list', 'gallery', 'search-form'));
// --- Enable Shortcodes in Widget Text ---
// (as loading Hybrid Core adds this)
// 1.9.8: added has_filter check
// note: https://core.trac.wordpress.org/changeset/41361
// TODO: maybe change this in conjunction with discreet text widget (filtered)?
if (!has_filter('widget_text', 'do_shortcode')) {add_filter('widget_text', 'do_shortcode');}
// Include only necessary Hybrid functions
// ---------------------------------------
// 1.8.0: updated to use the Hybrid Core 3 versions of these files
// 2.1.1: use file hierarchy to allow child theme file overrides
// --- Hybrid Attributes ---
// (for the better/cleaner markup)
$attributes = bioship_file_hierarchy('file', 'hybrid3-attr.php', $vthemedirs['includes']);
require_once($attributes);
// --- Template hierarchy ---
// (to support improved template locations)
$template = bioship_file_hierarchy('file', 'hybrid3-template.php', $vthemedirs['includes']);
require_once($template);
// --- general template functions ---
$templategeneral = bioship_file_hierarchy('file', 'hybrid3-template-general.php', $vthemedirs['includes']);
require_once($templategeneral);
// --- load media template ---
// 1.8.5: Load the media template so that attachments are not fatal
// (or we could strip media functions from hybrid3-attr.php?)
$templatemedia = bioship_file_hierarchy('file', 'hybrid3-template-media.php', $vthemedirs['includes']);
require_once($templatemedia);
// --- load utility functions ---
// (fix for possible undefined hybrid_get_menu_location_name)
$utility = bioship_file_hierarchy('file', 'hybrid3-utility.php', $vthemedirs['includes']);
require_once($utility);
// --- conditional Hybrid Media Grabber loader ---
if (!function_exists('bioship_load_hybrid_media')) {
function bioship_load_hybrid_media() {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__);}
global $vthemedirs;
// 2.1.1: use file hierarchy here to allow child theme file overrides
$mediagrabber = bioship_file_hierarchy('file', 'hybrid-media-grabber.php', $vthemedirs['includes']);
if ($mediagrabber) {require_once($mediagrabber);}
}
}
// --- meta character set tag ---
// 1.8.5: moved here from header.php to prevent duplicate if using Hybrid
if (!function_exists('bioship_meta_charset')) {
// 2.1.1: moved add_action internally for consistency
add_action('wp_head', 'bioship_meta_charset', 0);
function bioship_meta_charset() {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__);}
// 2.1.1: added esc_attr wrapper to output
echo '';
}
}
// --- add pingback link to document head ---
if (!function_exists('bioship_pingback_link')) {
// 2.1.1: move add_action internally for consistency
add_action('wp_head', 'bioship_pingback_link', 3);
function bioship_pingback_link() {
if (THEMETRACE) {bioship_trace('F',__FUNCTION__,__FILE__);}
if (get_option('default_ping_status') == 'open') {
// 2.1.1: added esc_url wrapper to output
echo '';
}
}
}
// --- Hybrid Core 3 compatibility fix ---
// 1.8.0: fix as missing for HC3 (from functions-sidebar.php)
if (!function_exists('hybrid_get_sidebar_name')) {
function hybrid_get_sidebar_name($id) {
global $wp_registered_sidebars;
if (!isset($wp_registered_sidebars[$id])) {return '';}
return $wp_registered_sidebars[$id]['name'];
}
}
}
// -----------------------
// Fix to Main Element IDs
// -----------------------
// 1.5.0: prevent duplicate element IDs via Hybrid attribute filters (eg. content and maincontent)
// 2.0.5: added missing function_exists wrappers to attribute fixes
// --- header ID attribute ---
if (!function_exists('bioship_hybrid_attr_header')) {
add_filter('hybrid_attr_header', 'bioship_hybrid_attr_header', 6);
function bioship_hybrid_attr_header($attr) {$attr['id'] = 'mainheader'; return $attr;}
}
// --- site description ID attribute ---
if (!function_exists('bioship_hybrid_attr_site_description')) {
// 1.9.0: added fix for new site-description attribute duplicate
add_filter('hybrid_attr_site-description', 'bioship_hybrid_attr_site_description', 6);
function bioship_hybrid_attr_site_description($attr) {$attr['id'] = 'site-desc'; return $attr;}
}
// --- content ID attribute ---
if (!function_exists('bioship_hybrid_attr_content')) {
add_filter('hybrid_attr_content', 'bioship_hybrid_attr_content', 6);
function bioship_hybrid_attr_content($attr) {$attr['id'] = 'maincontent'; return $attr;}
}
// --- footer ID attribute ---
if (!function_exists('bioship_attr_footer')) {
add_filter('hybrid_attr_footer', 'bioship_hybrid_attr_footer', 6);
function bioship_hybrid_attr_footer($attr) {$attr['id'] = 'mainfooter'; return $attr;}
}
// =============
// === SKULL ===
// =============
// --- Load the Skull ---
// (head, resource and layout calculation functions)
// (override pluggable skull functions in Child Theme functions.php)
$skull = bioship_file_hierarchy('file', 'skull.php');
require_once($skull);
// ================
// === SKELETON ===
// ================
// --- Load Hook definitions ---
// (page template layout definitions)
// 1.9.0: load hook definitions before skeleton.php
$hooks = bioship_file_hierarchy('file', 'hooks.php');
require_once($hooks);
// --- Load the Skeleton ---
// (all layout and template tag functions)
$skeleton = bioship_file_hierarchy('file', 'skeleton.php');
require_once($skeleton);
// ==============
// === MUSCLE ===
// ==============
// --- Load all the Muscle ---
// (extended theme feature functions ---
$muscle = bioship_file_hierarchy('file', 'muscle.php');
if ($muscle) {require_once($muscle);}
// ============
// === SKIN ===
// ============
// Note: skin.php is used for outputting the Dynamic CSS
// but all the Skin trigger and enqueueing functions were here
// 2.1.1: but now have all been moved to the end of skull.php
// -------------------
// Fully shipped bruz.