* $api = new api_skins();
* # Optional - if $ipsclass is not passed, it'll init
* $api->ipsclass =& $this->ipsclass;
* $api->api_init();
* $api->skin_add_bits( $path_to_xml_file );
* $api->skin_add_macros( $path_to_xml_file );
* $messages = $api->skin_rebuild_caches( 0 );
* print implode( "
", $messages[1] );
* $messages = $api->skin_rebuild_caches( $messages[0] );
*
*
* Macros for use with this file can be exported via the ACP
* Skin Import/Export page
*
* Templates for use with this file can be exported via the ACP
* Skin Sets Overview page when IN_DEV mode is enabled - it is
* recommended to add the name of your skin file under the
* "Developers: Export Module Skin Files" section to export
* all templates for your skin group.
*
* Example - if you make a skin_links skin template file, enter
* "links" in the form field and download the xml file.
*
* The skin_rebuild_caches rebuilds one skin set at a time - it
* rebuilds the next skin set id higher than the id you pass it.
* On first function call, pass a 0. On subsequent function
* calls pass it the 1st array value (index 0) returned from
* the previous call. It rebuilds one skin set at a time to
* prevent time outs - it is recommended in your script that
* you redirect to a new page passing the appropriate skin id
* value after each rebuild - when this function returns a 0
* for index 0, all skin sets will be rebuild. Index 1 of the
array returned will be an array of messages.
*
* @package InvisionPowerBoard
* @subpackage APIs
* @author Matt Mecham
* @copyright Invision Power Services, Inc.
* @version 2.1
*/
if ( ! defined( 'IPS_API_PATH' ) )
{
/**
* Define classes path
*/
define( 'IPS_API_PATH', dirname(__FILE__) ? dirname(__FILE__) : '.' );
}
if ( ! class_exists( 'api_core' ) )
{
require_once( IPS_API_PATH.'/api_core.php' );
}
/**
* API: Skins
*
* This class deals with all available skin insertion functions.
*
* @package InvisionPowerBoard
* @subpackage APIs
* @author Brandon Farber
* @version 2.2
* @since 2.2.0
*/
class api_skins extends api_core
{
/**
* IPS Class Object
*
* @var object
*/
//var $ipsclass;
var $xml;
var $cache_func;
/*-------------------------------------------------------------------------*/
// Add skin templates to IPB
/*-------------------------------------------------------------------------*/
/**
* Adds skin templates to IPB master template set which will filter down to child skins
*
* @param string Path to xml file containing skin templates (Note: templates can
* be exported from ACP when IN_DEV mode is enabled with the
* Developer Export options at the bottom of the skin sets overview)
* @return void;
*/
function skin_add_bits( $xml_file_path )
{
//-------------------------------
// Check?
//-------------------------------
if ( ! $xml_file_path )
{
$this->api_error[] = "input_missing_fields";
return;
}
require_once( KERNEL_PATH.'class_xml.php' );
$this->xml = new class_xml();
//-------------------------------
// Get file contents
//-------------------------------
$skin_content = implode( "", file($xml_file_path) );
//-------------------------------
// Unpack the datafile (TEMPLATES)
//-------------------------------
$this->xml->xml_parse_document( $skin_content );
//-------------------------------
// (TEMPLATES)
//-------------------------------
if ( ! is_array( $this->xml->xml_array['templateexport']['templategroup']['template'] ) )
{
$this->api_error[] = "xml_file_not_valid";
return;
}
foreach( $this->xml->xml_array['templateexport']['templategroup']['template'] as $id => $entry )
{
$this->ipsclass->DB->allow_sub_select = 1;
$row = $this->ipsclass->DB->simple_exec_query( array( 'select' => 'suid',
'from' => 'skin_templates',
'where' => "group_name='{$entry['group_name']['VALUE']}' AND func_name='{$entry['func_name']['VALUE']}' and set_id=1"
) );
if ( $row['suid'] )
{
$this->ipsclass->DB->allow_sub_select = 1;
$this->ipsclass->DB->do_update( 'skin_templates', array( 'func_data' => $entry[ 'func_data' ]['VALUE'],
'section_content' => $entry[ 'section_content' ]['VALUE'],
'updated' => time()
)
, 'suid='.$row['suid'] );
}
else
{
$this->ipsclass->DB->allow_sub_select = 1;
$this->ipsclass->DB->do_insert( 'skin_templates', array( 'func_data' => $entry[ 'func_data' ]['VALUE'],
'func_name' => $entry[ 'func_name' ]['VALUE'],
'section_content' => $entry[ 'section_content' ]['VALUE'],
'group_name' => $entry[ 'group_name' ]['VALUE'],
'updated' => time(),
'set_id' => 1
) );
}
}
}
/*-------------------------------------------------------------------------*/
// Add macros to IPB
/*-------------------------------------------------------------------------*/
/**
* Adds macros to IPB master templates which will filter down to child skins
*
* @param string Path to xml file containing macros (Note: macros can
* be exported from ACP when IN_DEV mode is enabled)
* @return void;
*/
function skin_add_macros( $xml_file_path )
{
//-------------------------------
// Check?
//-------------------------------
if ( !$xml_file_path )
{
$this->api_error[] = "input_missing_fields";
return;
}
require_once( KERNEL_PATH.'class_xml.php' );
$this->xml = new class_xml();
//-------------------------------
// Get file contents
//-------------------------------
$macro_content = implode( "", file($xml_file_path) );
//-------------------------------
// Unpack the datafile (TEMPLATES)
//-------------------------------
$this->xml->xml_parse_document( $macro_content );
//-------------------------------
// (MACRO)
//-------------------------------
if ( ! is_array( $this->xml->xml_array['macroexport']['macrogroup']['macro'] ) )
{
$this->api_error[] = "xml_file_not_valid";
return;
}
foreach( $this->xml->xml_array['macroexport']['macrogroup']['macro'] as $id => $entry )
{
$this->ipsclass->DB->allow_sub_select = 1;
$row = $this->ipsclass->DB->simple_exec_query( array( 'select' => 'macro_id',
'from' => 'skin_macro',
'where' => "macro_value='{$entry['macro_value']['VALUE']}' and macro_set=1"
) );
if ( $row['macro_id'] )
{
$this->ipsclass->DB->allow_sub_select = 1;
$this->ipsclass->DB->do_update( 'skin_macro', array( 'macro_replace' => $entry['macro_replace']['VALUE'] ), "macro_value='{$entry['macro_value']['VALUE']}' and macro_set=1" );
}
else
{
$this->ipsclass->DB->allow_sub_select = 1;
$this->ipsclass->DB->do_insert( 'skin_macro', array( 'macro_value' => $entry['macro_value']['VALUE'],
'macro_replace' => $entry['macro_replace']['VALUE'],
'macro_set' => 1 ) );
}
}
}
/*-------------------------------------------------------------------------*/
// Rebuild skin caches
/*-------------------------------------------------------------------------*/
/**
* Rebuilds template caches to cache new skins to .php files
*
* @param int Last skin id completed (returned upon completion of prior skin)
* @return array Returns: Skin id completed (which can be passed back to this
* function on next run) and an array of messages
*/
function skin_rebuild_caches( $completed=1 )
{
$this->ipsclass->DB->load_cache_file( ROOT_PATH.'sources/sql/'.SQL_DRIVER.'_api_queries.php', 'sql_api_queries' );
//-----------------------------------
// Get ACP library
//-----------------------------------
require_once( ROOT_PATH.'sources/lib/admin_cache_functions.php' );
$this->cache_func = new admin_cache_functions();
$this->cache_func->ipsclass =& $this->ipsclass;
//-----------------------------------
// Image cache url
//-----------------------------------
$row = $this->ipsclass->DB->simple_exec_query ( array ( 'select' => 'conf_value, conf_default', 'from' => 'conf_settings', 'where' => "conf_key='ipb_img_url'" ) );
$this->ipsclass->vars['ipb_img_url'] = $row['conf_value'] != "" ? $row['conf_value'] : $row['conf_default'];
if ( $this->ipsclass->vars['ipb_img_url'] == "{blank}" )
{
$this->ipsclass->vars['ipb_img_url'] = "";
}
//-------------------------------
// Next skin to do?
//-------------------------------
$completed = $completed > 0 ? intval($completed) : 1;
//-----------------------------------
// Get skins
//-----------------------------------
$this->ipsclass->DB->simple_construct( array( 'select' => '*',
'from' => 'skin_sets',
'where' => 'set_skin_set_id > '.$completed,
'order' => 'set_skin_set_id',
'limit' => array( 0, 1 )
) );
$this->ipsclass->DB->simple_exec();
//-----------------------------------
// Got a biggun?
//-----------------------------------
$r = $this->ipsclass->DB->fetch_row();
if ( $r['set_skin_set_id'] )
{
$this->cache_func->_rebuild_all_caches( array($r['set_skin_set_id']) );
return array( 'completed' => $r['set_skin_set_id'], 'messages' => $this->cache_func->messages );
}
else
{
return array( 'completed' => 0, 'messages' => array( 'No more skins to rebuild' ) );
}
}
/*-------------------------------------------------------------------------*/
// Rebuild update template bit
/*-------------------------------------------------------------------------*/
/**
* Updates a template bit from a previous version to the current version
* NOTE: This only changes the format of the data and doesn't update the
* actual HTML.
*
* @param string Template HTML
* @return string Template HTML
*/
function skin_update_template_bit( $html='' )
{
//-----------------------------------------
// INIT
//-----------------------------------------
$debug = 0;
$_html = $html;
//-----------------------------------------
// Fix up basic tags
//-----------------------------------------
$html = preg_replace( "/{ipb\.script_url}/i", '{$this->ipsclass->base_url}' , $html);
$html = preg_replace( "/{ipb\.session_id}/i", '{$this->ipsclass->session_id}', $html);
//-----------------------------------------
// Fix up the IF statements
//-----------------------------------------
# IF / ELSE IF / ELSE
$html = preg_replace_callback( "#(?:\s+?)?<(if=[\"'].+?[\"'])>(.+?)\s+?". htmlspecialchars( $html ); exit();
if ( $debug )
{
$_string = "\n===================================================";
$_string .= "\n Date: ". date( 'r' );
$_string .= "\n---ORIGINAL----------------------------------------";
$_string .= "\n".$_html;
$_string .= "\n---CONVERTED---------------------------------------";
$_string .= "\n".$html;
if ( $FH = @fopen( ROOT_PATH . 'cache/template_update_debug_log_'.date('m_d_y').'.cgi', 'a' ) )
{
@fwrite( $FH, $_string );
@fclose( $FH );
}
}
return $html;
}
/*-------------------------------------------------------------------------*/
// Fix up an if / else if / else statement
/*-------------------------------------------------------------------------*/
/*
*
* MAIN IF
*
*
* ELSE IF
*
* ELSE
*
*
*/
function _func_fix_if_elseif_else( $matches=array() )
{
//-----------------------------------------
// INIT
//-----------------------------------------
$if = '';
$if_html = '';
$else_if = '';
$else_if_html = '';
$else_html = '';
$formatted = '';
//-----------------------------------------
// What are we doing?
//-----------------------------------------
if ( count( $matches ) == 6 )
{
$if = trim( $matches[1] );
$if_html = trim( $matches[2] );
$else_if = trim( $matches[3] );
$else_if_html = trim( $matches[4] );
$else_html = trim( $matches[5] );
}
else if ( count( $matches ) == 5 )
{
$if = trim( $matches[1] );
$if_html = trim( $matches[2] );
$else_if = trim( $matches[3] );
$else_if_html = trim( $matches[4] );
}
else
{
$if = trim( $matches[1] );
$if_html = trim( $matches[2] );
$else_html = trim( $matches[3] );
}
//-----------------------------------------
// OK...
//-----------------------------------------
if ( $if AND $else_if AND $else_html )
{
$formatted = "<".$if.">\n";
$formatted .= $if_html . "\n";
$formatted .= " \n";
$formatted .= "\t<".$else_if.">\n";
$formatted .= $else_if_html."\n";
$formatted .= "\t \n";
$formatted .= $else_html . "\n";
$formatted .= "\t