$Date: 2006-05-25 10:15:22 -0400 (Thu, 25 May 2006) $ | > $Revision: 278 $ | > $Author: bfarber $ +--------------------------------------------------------------------------- | | > API: Skins | > Module written by Brandon Farber | > Date started: Tuesday June 6th 2006 (11:12) | +-------------------------------------------------------------------------- */ /** * API: Skins * * EXAMPLE USAGE * * $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+?(.+?)\s+?(.+?)#is", array( $this, '_func_fix_if_elseif_else' ), $html ); # IF / ELSE IF $html = preg_replace_callback( "#(?:\s+?)?<(if=[\"'].+?[\"'])>(.+?)\s+?(.+?)#is", array( $this, '_func_fix_if_elseif_else' ), $html ); # IF / ELSE $html = preg_replace_callback( "#(?:\s+?)?<(if=[\"'].+?[\"'])>(.+?)\s+?(.+?)#is", array( $this, '_func_fix_if_elseif_else' ), $html ); //----------------------------------------- // Sort out the IF content //----------------------------------------- $html = preg_replace_callback( "##is", array( $this, '_func_check_if_statement' ), $html ); //----------------------------------------- // Sort out the rest of the tags... //----------------------------------------- $html = preg_replace( "#ipb\.(member|vars|skin|lang|input)#i", '$this->ipsclass->\\1', $html ); #print "
". 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\n";
			$formatted .= "\n";
		}
		else if ( $if AND $else_if )
		{
			$formatted  = "<".$if.">\n";
			$formatted .= $if_html . "\n";
			$formatted .= "\n";
			$formatted .= "\t<".$else_if.">\n";
			$formatted .= $else_if_html."\n";
			$formatted .= "\t\n";
			$formatted .= "\n";
		}
		else if ( $if AND $else_html )
		{
			$formatted  = "<".$if.">\n";
			$formatted .= $if_html . "\n";
			$formatted .= "\n";
			$formatted .= $else_html."\n";
			$formatted .= "\n";
		}
		
		return $formatted;
	}
	
	//===================================================
	// Sort out left bit of comparison
	//===================================================
	
	function _func_fix_if_statement($left, $andor="", $fs="", $ls="")
	{
		$left = trim($this->_trim_slashes($left));
		
		if ( preg_match( "/^ipb\./", $left ) )
		{
			$left = preg_replace( "/^ipb\.(.+?)$/", '$this->ipsclass->'."\\1", $left );
		}
		else
		{
			$left = '$'.$left;
		}
		
		return $andor.$fs.$left.$ls;
	}
	
	//===================================================
	// Statement: Prep AND OR, etc
	//===================================================
	
	function _func_check_if_statement( $matches=array() )
	{
		//-----------------------------------------
		// INIT
		//-----------------------------------------
		
		$quotes = $matches[1];
		$code   = $this->_trim_slashes( $matches[2] );
		
		$code = preg_replace( "/(^|and|or)(\s+)(.+?)(\s|$)/ise", "\$this->_func_fix_if_statement('\\3', '\\1', '\\2', '\\4')", ' '.$code );
		
		$code = preg_replace( '#\${1,}#i', '$', $code );
		
		return "";
	}
	
	//===================================================
	// Remove leading and trailing newlines
	//===================================================
	
	function _trim_slashes($code)
	{
		$code = str_replace( '\"' , '"', $code );
		$code = str_replace( "\\'", "'", $code );
		return $code;
	}
	
}

?>