silverstripe-framework/parsers/TextParser.php

63 lines
1.9 KiB
PHP
Raw Normal View History

<?php
/**
* Parses text in a variety of ways.
2014-08-15 08:53:05 +02:00
*
* Called from a template by $Content.Parse(SubClassName), similar to $Content.XML.
2014-08-15 08:53:05 +02:00
* This will work on any Text database field (Or a sub-class, such as HTMLText,
* although it's usefulness in this situation is more limited).
2014-08-15 08:53:05 +02:00
*
* Any sub-classes of TextParser must implement a parse() method.
* This should take $this->content and parse it however you want. For an example
* of the implementation, @see BBCodeParser.
2014-08-15 08:53:05 +02:00
*
* Your sub-class will be initialized with a string of text, then parse() will be called.
* parse() should (after processing) return the formatted string.
2014-08-15 08:53:05 +02:00
*
* Note: $this->content will have NO conversions applied to it.
* You should run Covert::raw2xml or whatever is appropriate before using it.
*
* Optionally (but recommended), is creating a static usable_tags method,
* which will return a SS_List of all the usable tags that can be parsed.
* This will (mostly) be used to create helper blocks - telling users what things will be parsed.
* Again, @see BBCodeParser for an example of the syntax
2014-08-15 08:53:05 +02:00
*
* @todo Define a proper syntax for (or refactor) usable_tags that can be extended as needed.
* @package framework
* @subpackage misc
*/
abstract class TextParser extends Object {
/**
* @var string
*/
protected $content;
2014-08-15 08:53:05 +02:00
/**
* Creates a new TextParser object.
2014-08-15 08:53:05 +02:00
*
* @param string $content The contents of the dbfield
*/
public function __construct($content = "") {
parent::__construct();
$this->content = $content;
parent::__construct();
}
2014-08-15 08:53:05 +02:00
/**
* Convenience method, shouldn't really be used, but it's here if you want it
*
* @param string $content
*/
public function setContent($content = "") {
$this->content = $content;
}
2014-08-15 08:53:05 +02:00
/**
* Define your own parse method to parse $this->content appropriately.
* See the class doc-block for more implementation details.
*
* @return DBField
*/
abstract public function parse();
}