Version 4.1.19.4

applications/convert/data/defaults/Library.txt

@@ -0,0 +1,62 @@
+<?php
+
+/**
+ * @brief		Converter Library <#CLASS#> Class
+ * @author		<a href='http://www.invisionpower.com'>Invision Power Services, Inc.</a>
+ * @copyright	(c) 2001 - 2016 Invision Power Services, Inc.
+ * @package		IPS Community Suite
+ * @subpackage	Converter
+ * @since		21 Jan 2015
+  */
+
+namespace IPS\convert\Library;
+
+/* To prevent PHP errors (extending class does not exist) revealing path */
+if ( !defined( '\IPS\SUITE_UNIQUE_KEY' ) )
+{
+	header( ( isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0' ) . ' 403 Forbidden' );
+	exit;
+}
+
+class _<#CLASS#> extends \IPS\convert\Library
+{
+	/**
+	 * @brief	Application
+	 */
+	public $app = '<#CLASS_LOWER#>';
+
+	/**
+	 * Returns an array of items that we can convert, including the amount of rows stored in the Community Suite as well as the recommend value of rows to convert per cycle
+	 *
+	 * @return	array
+	 */
+	public function menuRows()
+	{
+		return array();
+	}
+	
+	/**
+	 * Returns an array of tables that need to be truncated when Empty Local Data is used
+	 *
+	 * @param	string	The method to truncate.
+	 * @return	array
+	 */
+	protected function truncate( $method )
+	{
+		return array();
+	}
+	
+	/**
+	 * This is how the insert methods will work - basically like 3.x, but we should be using the actual classes to insert the data unless there is a real world reason not too.
+	 * Using the actual routines to insert data will help to avoid having to resynchronize and rebuild things later on, thus resulting in less conversion time being needed overall.
+	 * Anything that parses content, for example, may need to simply insert directly then rebuild via a task over time, as HTML Purifier is slow when mass inserting content.
+	 */
+	
+	/**
+	 * A note on logging -
+	 * If the data is missing and it is unlikely that any source software would be able to provide this, we do not need to log anything and can use default data (for example, group_layout in convertLeaderGroups).
+	 * If the data is missing and it is likely that a majority of the source software can provide this, we should log a NOTICE and use default data (for example, a_casesensitive in convertAcronyms).
+	 * If the data is missing and it is required to convert the item, we should log a WARNING and return FALSE.
+	 * If the conversion absolutely cannot proceed at all (filestorage locations not writable, for example), then we should log an ERROR and throw an \IPS\convert\Exception to completely halt the process and redirect to an error screen showing the last logged error.
+	 */
+}

applications/convert/data/defaults/Software.txt

@@ -0,0 +1,151 @@
+<?php
+
+/**
+ * @brief		Converter <#CLASS#> Class
+ * @author		<a href='http://www.invisionpower.com'>Invision Power Services, Inc.</a>
+ * @copyright	(c) 2001 - 2016 Invision Power Services, Inc.
+ * @package		IPS Community Suite
+ * @subpackage	Converter
+ * @since		21 Jan 2015
+ */
+
+namespace IPS\convert\Software\<#APP#>;
+
+/* To prevent PHP errors (extending class does not exist) revealing path */
+if ( !defined( '\IPS\SUITE_UNIQUE_KEY' ) )
+{
+	header( ( isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0' ) . ' 403 Forbidden' );
+	exit;
+}
+
+class _<#CLASS#> extends \IPS\convert\Software
+{
+	/**
+	 * Software Name
+	 *
+	 * @return	string
+	 */
+	public static function softwareName()
+	{
+		/* Child classes must override this method */
+		return "<#CLASS#>";
+	}
+	
+	/**
+	 * Software Key
+	 *
+	 * @return	string
+	 */
+	public static function softwareKey()
+	{
+		/* Child classes must override this method */
+		return "<#CLASS_LOWER#>";
+	}
+	
+	/**
+	 * Content we can convert from this software. 
+	 *
+	 * @return	array|NULL
+	 * @note	NULL indicates this converter cannot be used yet, useful to move redirect scripts into the 4.x framework
+	 */
+	public static function canConvert()
+	{
+		return array(
+			
+		);
+	}
+	
+	/**
+	 * Can we convert passwords from this software.
+	 *
+	 * @return 	boolean
+	 */
+	public static function loginEnabled()
+	{
+		return FALSE;
+	}
+	
+	/**
+	 * Can we convert settings?
+	 *
+	 * @return	boolean
+	 */
+	public static function canConvertSettings()
+	{
+		return FALSE;
+	}
+	
+	/**
+	 * Settings Map
+	 *
+	 * @return	array
+	 */
+	public function settingsMap()
+	{
+		return array();
+	}
+	
+	/**
+	 * Settings Map Listing
+	 *
+	 * @return	array
+	 */
+	public function settingsMapList()
+	{
+		return array();
+	}
+	
+	/**
+	 * Returns a block of text, or a language string, that explains what the admin must do to start this conversion
+	 *
+	 * @return	string|NULL
+	 */
+	public static function getPreConversionInformation()
+	{
+		return NULL;
+	}
+	
+	/**
+	 * List of conversion methods that require additional information
+	 *
+	 * @return	array
+	 */
+	public static function checkConf()
+	{
+		return array();
+	}
+	
+	/**
+	 * Get More Information
+	 *
+	 * @param	string	$method	Conversion method
+	 * @return	array
+	 */
+	public function getMoreInfo( $method )
+	{
+		return array();
+	}
+	
+	/**
+	 * Finish - Adds everything it needs to the queues and clears data store
+	 *
+	 * @return	array		Messages to display
+	 */
+	public function finish()
+	{
+		return array();
+	}
+	
+	/**
+	 * Fix post data
+	 *
+	 * @param 	string		raw post data
+	 * @return 	string		parsed post data
+	 */
+	public static function fixPostData( $post )
+	{
+		return $post;
+	}
+	
+	// Insert convertX methods here
+}