Extension extends AbstractExtension implements ExtensionInterface, GlobalsInterface
FinalYes
Basic extension adding phpDocumentor specific functionality for Twig templates.
Global variables:
- ast_node, the current $data element
Functions:
- *path(string) *, converts the given relative path to be based of the projects root instead of the current directory
Filters:
- markdown, converts the associated text from Markdown formatting to HTML.
- trans, translates the given string
- route, attempts to generate a URL for a given Descriptor
- sort_desc, sorts the given objects by their Name property/getter in a descending fashion
- sort_asc, sorts the given objects by their Name property/getter in a ascending fashion
Table of Contents
Interfaces
- ExtensionInterface
- An interface shared by all Twig interfaces intended for phpDocumentor.
- GlobalsInterface
Properties
- $documentationSet : DocumentationSetDescriptor
- $markdownConverter : ConverterInterface
- $pathBuilder : PathBuilder
- $project : ProjectDescriptor
- $relativePathToRootConverter : RelativePathToRootConverter
- $routeRenderer : LinkRenderer
Methods
- __construct() : mixed
- Registers the structure and transformation with this extension.
- getFilters() : array<string|int, TwigFilter>
- Returns a list of all filters that are exposed by this extension.
- getFunctions() : array<string|int, TwigFunction>
- Returns a listing of all functions that this extension adds.
-
getGlobals()
: Descriptor, usesNamespaces: bool, usesPackages: bool, destinationPath: ?string, parameter: array
- Initialize series of globals used by the writers to set the context
- getTests() : array<int, TwigTest>
- renderDescription() : string
- renderRoute() : array<string|int, string>|string
- sort() : ArrayIterator<string|int, Descriptor>
- sortByVisibility() : ArrayIterator<string|int, Descriptor>
- contextRouteRenderer() : LinkRenderer
Properties
$documentationSet read-only
private
DocumentationSetDescriptor
$documentationSet
$markdownConverter read-only
private
ConverterInterface
$markdownConverter
$pathBuilder read-only
private
PathBuilder
$pathBuilder
$project read-only
private
ProjectDescriptor
$project
$relativePathToRootConverter read-only
private
RelativePathToRootConverter
$relativePathToRootConverter
$routeRenderer
private
LinkRenderer
$routeRenderer
Methods
__construct()
Registers the structure and transformation with this extension.
public
__construct(ProjectDescriptor $project, DocumentationSetDescriptor $documentationSet, ConverterInterface $markdownConverter, LinkRenderer $routeRenderer, RelativePathToRootConverter $relativePathToRootConverter, PathBuilder $pathBuilder) : mixed
Parameters
- $project : ProjectDescriptor
-
Represents the complete Abstract Syntax Tree.
- $documentationSet : DocumentationSetDescriptor
- $markdownConverter : ConverterInterface
- $routeRenderer : LinkRenderer
- $relativePathToRootConverter : RelativePathToRootConverter
- $pathBuilder : PathBuilder
getFilters()
Returns a list of all filters that are exposed by this extension.
public
getFilters() : array<string|int, TwigFilter>
Return values
array<string|int, TwigFilter>getFunctions()
Returns a listing of all functions that this extension adds.
public
getFunctions() : array<string|int, TwigFunction>
This method is automatically used by Twig upon registering this extension (which is done automatically by phpDocumentor) to determine an additional list of functions.
See the Class' DocBlock for a listing of functionality added by this Extension.
Return values
array<string|int, TwigFunction>getGlobals()
Initialize series of globals used by the writers to set the context
public
getGlobals() : Descriptor, usesNamespaces: bool, usesPackages: bool, destinationPath: ?string, parameter: array, env: mixed}
Return values
Descriptor, usesNamespaces: bool, usesPackages: bool, destinationPath: ?string, parameter: arraygetTests()
public
getTests() : array<int, TwigTest>
Return values
array<int, TwigTest>renderDescription()
public
renderDescription(array<string|int, mixed> $context, DescriptionDescriptor|null $description) : string
Parameters
- $context : array<string|int, mixed>
- $description : DescriptionDescriptor|null
Return values
stringrenderRoute()
public
renderRoute(array<string|int, mixed> $context, array<string|int, Type>|Type|DescriptorAbstract|Fqsen|Reference|Path|string|iterable<string|int, mixed> $value, string $presentation) : array<string|int, string>|string
Parameters
- $context : array<string|int, mixed>
- $value : array<string|int, Type>|Type|DescriptorAbstract|Fqsen|Reference|Path|string|iterable<string|int, mixed>
- $presentation : string
Return values
array<string|int, string>|stringsort()
public
sort(string $direction, Collection<string|int, Descriptor> $collection) : ArrayIterator<string|int, Descriptor>
Parameters
- $direction : string
- $collection : Collection<string|int, Descriptor>
Return values
ArrayIterator<string|int, Descriptor>sortByVisibility()
public
sortByVisibility(Collection<string|int, Descriptor> $collection) : ArrayIterator<string|int, Descriptor>
Parameters
- $collection : Collection<string|int, Descriptor>
Return values
ArrayIterator<string|int, Descriptor>contextRouteRenderer()
private
contextRouteRenderer(array<string|int, mixed> $context) : LinkRenderer
Parameters
- $context : array<string|int, mixed>