WB 2.08.x

06 Nov-2013 Build 1993 Manuela v.d.Decken(DarkViper)

! /module/output_filter/filters/filterWbLink added extended format to [wblinkXX] - tag

+ /framework/WbLinkAbstract.php added abstract class/interface for filterWbLink

if(!defined('REVISION')) define('REVISION', '1993');

<?php

/**

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.

 *

 * This program is free software: you can redistribute it and/or modify

 * it under the terms of the GNU General Public License as published by

 * the Free Software Foundation, either version 3 of the License, or

 * (at your option) any later version.

 *

 * 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/>.

 */

/**

 * WbLinkAbstract.php

 *

 * @category     Core

 * @package      Core_Interfaces

 * @subpackage   WbLink outputfilter

 * @copyright    Manuela v.d.Decken <manuela@isteam.de>

 * @author       Manuela v.d.Decken <manuela@isteam.de>

 * @license      http://www.gnu.org/licenses/gpl.html   GPL License

 * @version      0.0.1

 * @revision     $Revision: $

 * @link         $HeadURL: $

 * @lastmodified $Date: $

 * @since        File available since 03.11.2013

 * @description  Interface definition for all addon/ * /WbLink.php

 */

abstract class WbLinkAbstract {

	protected $oDb  = null;

	protected $oReg = null;

	final public function __construct()

	{

		$this->oDb  = WbDatabase::getInstance();

		$this->oReg = WbAdaptor::getInstance();

	}

	abstract public function makeLinkFromTag(array $aReplacement);

//	abstract public function generateLinkList(Template $oTpl);

} // end of class WbLinkAbstract

 * @param  string $content : contains the full content of the current page

 * @return string

 * @description replace all "[wblink{page_id}{?addon=n&item=n...}]" with real links to accessfiles<br />

 *     All modules must offer the class 'WbLink'(implementing 'WbLinkAbstract'), to be taken into consideration.

	function doFilterWbLink($sContent)

		$oDb  = WbDatabase::getInstance();

		$oReg = WbAdaptor::getInstance();

		$aReplaceList = array();

		$sPattern = '/\[wblink([0-9]+)\??([^\]]*)\]/is';

		if(preg_match_all($sPattern,$sContent,$aMatches))

		// iterate through all found matches

			foreach($aMatches[0] as $iKey => $sKeyString )

				$aReplaceList[$sKeyString] = array();

			// use original Tag to save PageId

				$aReplaceList[$sKeyString]['PageId'] = $aMatches[1][$iKey];

			// if there are additional arguments given

				if($aMatches[2][$iKey])

				{

					$aReplaceList[$sKeyString]['Args'] = array();

					$aArgs = explode('&', $aMatches[2][$iKey]);

					foreach($aArgs as $sArgument)

					{

						$aTmp = explode('=', $sArgument);

						$aReplaceList[$sKeyString]['Args'][$aTmp[0]] = $aTmp[1];

					}

			if(sizeof($aReplaceList) > 0)

			{ // iterate list if replacements are available

				foreach($aReplaceList as $sKey => $aReplacement)

				{

				// set link on failure ('#' means, still stay on current page)

					$aReplaceList[$sKey] = '#';

				// handle normal pages links

					if(!isset($aReplacement['Args'])) 

					{

					// read corresponding link from table 'pages'

						$sql = 'SELECT `link` FROM `'.$oDb->TablePrefix.'pages` WHERE `page_id` = '.(int)$aReplacement['PageId'];

						if(($sLink = $oDb->get_one($sql)))

						{

							$sLink = trim(str_replace('\\', '/', $sLink), '/');

						// test if valid accessfile is available

							if(is_readable($oReg->AppPath.$oReg->PagesDir.$sLink.$oReg->PageExtension))

							{

							// create absolute URL

								$aReplaceList[$sKey] = $oReg->AppUrl.$oReg->PagesDir.$sLink.$oReg->PageExtension;

							}

						}

					// handle links of modules

					}else 

					{

					// build name of the needed class

						$sClass = 'm_'.$aReplacement['Args']['addon'].'_WbLink';

					// remove addon name from replacement array

						unset($aReplacement['Args']['addon']);

						if(class_exists($sClass))

						{

						// instantiate class

							$oWbLink = new $sClass();

						// the class must implement the interface

							if($oWbLink instanceof WbLinkAbstract)

							{

							// create real link from replacement data

								$aReplaceList[$sKey] = $oWbLink->makeLinkFromTag($aReplacement);

							}

						}

					}

				}

			// extract indexes into a new array

				$aSearchList = array_keys($aReplaceList);

			// replace all identified wblink-tags in content

				$sContent = str_replace($aSearchList, $aReplaceList, $sContent);

			}

		return $sContent;