<?php
/**
 * Modules related functions.
 *
 * @version		$Rev: 522 $
 * @author		Jordi Canals
 * @copyright   Copyright (C) 2008, 2009, 2010 Jordi Canals
 * @license		GNU General Public License version 2
 * @link		http://alkivia.org
 * @package		Alkivia
 * @subpackage	Framework
 *

	Copyright 2008, 2009, 2010 Jordi Canals <devel@jcanals.cat>

	This program is free software; you can redistribute it and/or
	modify it under the terms of the GNU General Public License
	version 2 as published by the Free Software Foundation.

	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
	GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program. If not, see <http://www.gnu.org/licenses/>.
 */

/**
 * Parse the plugin readme.txt file to retrieve plugin's metadata.
 *
 * The metadata of the plugin's readme searches for the following in the readme.txt
 * header. All metadata must be on its own line. The below is formatted for printing.
 *
 * <code>
 * Contributors: contributors nicknames, comma delimited
 * Donate link: Link to plugin donate page
 * Tags: Plugin tags, comma delimited
 * Requires at least: Minimum WordPress version required
 * Tested up to: Higher WordPress version the plugin has been tested.
 * Stable tag: Latest stable tag in repository.
 * </code>
 *
 * Readme data returned array cointains the following:
 * 		- 'Contributors' - An array with all contributors nicknames.
 * 		- 'Tags' - An array with all plugin tags.
 * 		- 'DonateURI' - The donations page address.
 * 		- 'HelpURI' - Link to the forum page.
 * 		- 'DocsURI' - Link to module documentation.
 *      - 'Required' - Minimum required WordPress version.
 *      - 'Tested' - Higher WordPress version this plugin has been tested.
 *      - 'Stable' - Last stable tag when this was released.
 *
 * The first 8kiB of the file will be pulled in and if the readme data is not
 * within that first 8kiB, then the plugin author should correct their plugin
 * and move the plugin data headers to the top.
 *
 * The readme file is assumed to have permissions to allow for scripts to read
 * the file. This is not checked however and the file is only opened for
 * reading.
 *
 * @param string $pluginFile Path to the plugin file (not the readme file)
 * @return array See above for description.
 */
function ak_module_readme_data( $pluginFile )
{
	$file = dirname($pluginFile) . '/readme.txt';

	if ( is_readable($file) ) {
    	$fp = fopen($file, 'r');	// Open just for reading.
	    $data = fread( $fp, 8192 );	// Pull the first 8kiB of the file in.
    	fclose($fp);				// Close the file.

	    preg_match( '|Contributors:(.*)$|mi', $data, $contributors );
    	preg_match( '|Donate link:(.*)$|mi', $data, $uri );
    	preg_match( '|Help link:(.*)$|mi', $data, $help ); // Not WP Standard
    	preg_match( '|Docs link:(.*)$|mi', $data, $docs ); // Not WP Standard
    	preg_match( '|Tags:(.*)|i', $data, $tags );
    	preg_match( '|Requires at least:(.*)$|mi', $data, $required );
    	preg_match( '|Tested up to:(.*)$|mi', $data, $tested );
    	preg_match( '|Stable tag:(.*)$|mi', $data, $stable );

	    foreach ( array( 'contributors', 'uri', 'help', 'docs', 'tags', 'required', 'tested', 'stable' ) as $field ) {
    		if ( !empty( ${$field} ) ) {
	    		${$field} = trim(${$field}[1]);
    		} else {
	    		${$field} = '';
    		}
	    }

    	$readme_data = array(
	    	'Contributors' => array_map('trim', explode(',', $contributors)),
			'Tags' => array_map('trim', explode(',', $tags)),
    		'DonateURI' => trim($uri),
    	    'HelpURI' => $help,
    	    'DocsURI' => $docs,
	    	'Requires' => trim($required),
			'Tested' => trim($tested),
			'Stable' => trim($stable) );
	} else {
	    $readme_data = array();
	}

	return $readme_data;
}

/**
 * Returns plugin data from readme.txt
 *
 * @deprecated since 0.5
 * @see ak_module_readme_data()
 *
 * @param string $pluginFile
 * @return array
 */
function ak_plugin_readme_data( $pluginFile )
{
    return ak_module_readme_data;
}

/**
 * Deactivated the plugin. Normally in case incompatibilities were detected.
 *
 * TODO: Run Deactivation HOOK
 *
 * @since 0.5
 *
 * @param string $name	Plugin name.
 * @return void
 */
function ak_deactivate_plugin( $name )
{
    $plugins = get_option('active_plugins');

	if ( in_array($name, $plugins)) {
	    array_splice($plugins, array_search($name, $plugins), 1);
		update_option('active_plugins', $plugins);
    }
}