| [ Index ] |
PHP Cross Reference of Unnamed Project |
[Source view] [Print] [Project Stats]
Functions for generating the HTML that Moodle should output. Please see http://docs.moodle.org/en/Developement:How_Moodle_outputs_HTML for an overview.
| Copyright: | 2009 Tim Hunt |
| License: | http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later |
| File Size: | 2142 lines (80 kb) |
| Included or required: | 0 times |
| Referenced: | 0 times |
| Includes or requires: | 0 files |
theme_config:: (41 methods):
load()
diagnose()
__construct()
init_page()
check_theme_arrows()
renderer_prefixes()
editor_css_url()
editor_css_files()
css_urls()
get_css_content()
get_css_content_debug()
get_css_content_editor()
get_css_files()
get_css_content_from_less()
get_less_variables()
get_extra_less_code()
javascript_url()
javascript_files()
resolve_excludes()
javascript_content()
post_process()
pix_url()
font_url()
setting_file_url()
setting_file_serve()
resolve_image_location()
resolve_font_location()
use_svg_icons()
force_svg_use()
image_exists()
find_theme_config()
find_theme_location()
get_renderer()
layout_info_for_page()
layout_file()
pagelayout_options()
setup_blocks()
get_region_name()
get_all_block_regions()
get_theme_name()
get_block_render_method()
xhtml_container_stack:: (7 methods):
__construct()
push()
pop()
pop_all_but_last()
discard()
log()
output_log()
Class: theme_config - X-Ref
This class represents the configuration variables of a Moodle theme.| load($themename) X-Ref |
| Load the config.php file for a particular theme, and return an instance of this class. (That is, this is a factory method.) param: string $themename the name of the theme. return: theme_config an instance of this class. |
| diagnose($themename) X-Ref |
| Theme diagnostic code. It is very problematic to send debug output to the actual CSS file, instead this functions is supposed to diagnose given theme and highlights all potential problems. This information should be available from the theme selection page or some other debug page for theme designers. param: string $themename return: array description of problems |
| __construct($config) X-Ref |
| Private constructor, can be called only from the factory method. param: stdClass $config |
| init_page(moodle_page $page) X-Ref |
| Let the theme initialise the page object (usually $PAGE). This may be used for example to request jQuery in add-ons. param: moodle_page $page |
| check_theme_arrows() X-Ref |
| Checks if arrows $THEME->rarrow, $THEME->larrow, $THEME->uarrow, $THEME->darrow have been set (theme/-/config.php). If not it applies sensible defaults. Accessibility: right and left arrow Unicode characters for breadcrumb, calendar, search forum block, etc. Important: these are 'silent' in a screen-reader (unlike > »), and must be accompanied by text. |
| renderer_prefixes() X-Ref |
| Returns output renderer prefixes, these are used when looking for the overridden renderers in themes. return: array |
| editor_css_url($encoded=true) X-Ref |
| Returns the stylesheet URL of this editor content param: bool $encoded false means use & and true use & in URLs return: moodle_url |
| editor_css_files() X-Ref |
| Returns the content of the CSS to be used in editor content return: array |
| css_urls(moodle_page $page) X-Ref |
| Get the stylesheet URL of this theme. param: moodle_page $page Not used... deprecated? return: moodle_url[] |
| get_css_content() X-Ref |
| Get the whole css stylesheet for production mode. NOTE: this method is not expected to be used from any addons. return: string CSS markup, already optimised and compressed |
| get_css_content_debug($type, $subtype, $sheet) X-Ref |
| Get the theme designer css markup, the parameters are coming from css_urls(). NOTE: this method is not expected to be used from any addons. param: string $type param: string $subtype param: string $sheet return: string CSS markup |
| get_css_content_editor() X-Ref |
| Get the whole css stylesheet for editor iframe. NOTE: this method is not expected to be used from any addons. return: string CSS markup |
| get_css_files($themedesigner) X-Ref |
| Returns an array of organised CSS files required for this output. param: bool $themedesigner return: array nested array of file paths |
| get_css_content_from_less($themedesigner) X-Ref |
| Return the CSS content generated from LESS the file. param: bool $themedesigner True if theme designer is enabled. return: bool|string Return false when the compilation failed. Else the compiled string. |
| get_less_variables() X-Ref |
| Return extra LESS variables to use when compiling. return: array Where keys are the variable names (omitting the @), and the values are the value. |
| get_extra_less_code() X-Ref |
| Return extra LESS code to add when compiling. This is intended to be used by themes to inject some LESS code before it gets compiled. If you want to inject variables you should use {@link self::get_less_variables()}. return: string The LESS code to inject. |
| javascript_url($inhead) X-Ref |
| Generate a URL to the file that serves theme JavaScript files. If we determine that the theme has no relevant files, then we return early with a null value. param: bool $inhead true means head url, false means footer return: moodle_url|null |
| javascript_files($type) X-Ref |
| Get the URL's for the JavaScript files used by this theme. They won't be served directly, instead they'll be mediated through theme/javascript.php. param: string $type Either javascripts_footer, or javascripts return: array |
| resolve_excludes($variable, $default = null) X-Ref |
| Resolves an exclude setting to the themes setting is applicable or the setting of its closest parent. param: string $variable The name of the setting the exclude setting to resolve param: string $default return: mixed |
| javascript_content($type) X-Ref |
| Returns the content of the one huge javascript file merged from all theme javascript files. param: bool $type return: string |
| post_process($css) X-Ref |
| Post processes CSS. This method post processes all of the CSS before it is served for this theme. This is done so that things such as image URL's can be swapped in and to run any specific CSS post process method the theme has requested. This allows themes to use CSS settings. param: string $css The CSS to process. return: string The processed CSS. |
| pix_url($imagename, $component) X-Ref |
| Return the URL for an image param: string $imagename the name of the icon. param: string $component specification of one plugin like in get_string() return: moodle_url |
| font_url($font, $component) X-Ref |
| Return the URL for a font param: string $font the name of the font (including extension). param: string $component specification of one plugin like in get_string() return: moodle_url |
| setting_file_url($setting, $filearea) X-Ref |
| Returns URL to the stored file via pluginfile.php. Note the theme must also implement pluginfile.php handler, theme revision is used instead of the itemid. param: string $setting param: string $filearea return: string protocol relative URL or null if not present |
| setting_file_serve($filearea, $args, $forcedownload, $options) X-Ref |
| Serve the theme setting file. param: string $filearea param: array $args param: bool $forcedownload param: array $options return: bool may terminate if file not found or donotdie not specified |
| resolve_image_location($image, $component, $svg = false) X-Ref |
| Resolves the real image location. $svg was introduced as an arg in 2.4. It is important because not all supported browsers support the use of SVG and we need a way in which to turn it off. By default SVG won't be used unless asked for. This is done for two reasons: 1. It ensures that we don't serve svg images unless we really want to. The admin has selected to force them, of the users browser supports SVG. 2. We only serve SVG images from locations we trust. This must NOT include any areas where the image may have been uploaded by the user due to security concerns. param: string $image name of image, may contain relative path param: string $component param: bool $svg If set to true SVG images will also be looked for. return: string full file path |
| resolve_font_location($font, $component) X-Ref |
| Resolves the real font location. param: string $font name of font file param: string $component return: string full file path |
| use_svg_icons() X-Ref |
| Return true if we should look for SVG images as well. return: bool |
| force_svg_use($setting) X-Ref |
| Forces the usesvg setting to either true or false, avoiding any decision making. This function should only ever be used when absolutely required, and before any generation of image URL's has occurred. DO NOT ABUSE THIS FUNCTION... not that you'd want to right ;) param: bool $setting True to force the use of svg when available, null otherwise. |
| image_exists($filepath, $svg = false) X-Ref |
| Checks if file with any image extension exists. The order to these images was adjusted prior to the release of 2.4 At that point the were the following image counts in Moodle core: - png = 667 in pix dirs (1499 total) - gif = 385 in pix dirs (606 total) - jpg = 62 in pix dirs (74 total) - jpeg = 0 in pix dirs (1 total) There is work in progress to move towards SVG presently hence that has been prioritiesed. param: string $filepath param: bool $svg If set to true SVG images will also be looked for. return: string image name with extension |
| find_theme_config($themename, $settings, $parentscheck = true) X-Ref |
| Loads the theme config from config.php file. param: string $themename param: stdClass $settings from config_plugins table param: boolean $parentscheck true to also check the parents. . return: stdClass The theme configuration |
| find_theme_location($themename) X-Ref |
| Finds the theme location and verifies the theme has all needed files and is not obsoleted. param: string $themename return: string full dir path or null if not found |
| get_renderer(moodle_page $page, $component, $subtype = null, $target = null) X-Ref |
| Get the renderer for a part of Moodle for this theme. param: moodle_page $page the page we are rendering param: string $component the name of part of moodle. E.g. 'core', 'quiz', 'qtype_multichoice'. param: string $subtype optional subtype such as 'news' resulting to 'mod_forum_news' param: string $target one of rendering target constants return: renderer_base the requested renderer. |
| layout_info_for_page($pagelayout) X-Ref |
| Get the information from {@link $layouts} for this type of page. param: string $pagelayout the the page layout name. return: array the appropriate part of {@link $layouts}. |
| layout_file($pagelayout) X-Ref |
| Given the settings of this theme, and the page pagelayout, return the full path of the page layout file to use. Used by {@link core_renderer::header()}. param: string $pagelayout the the page layout name. return: string Full path to the lyout file to use |
| pagelayout_options($pagelayout) X-Ref |
| Returns auxiliary page layout options specified in layout configuration array. param: string $pagelayout return: array |
| setup_blocks($pagelayout, $blockmanager) X-Ref |
| Inform a block_manager about the block regions this theme wants on this page layout. param: string $pagelayout the general type of the page. param: block_manager $blockmanager the block_manger to set up. |
| get_region_name($region, $theme) X-Ref |
| Gets the visible name for the requested block region. param: string $region The region name to get param: string $theme The theme the region belongs to (may come from the parent theme) return: string |
| get_all_block_regions() X-Ref |
| Get the list of all block regions known to this theme in all templates. return: array internal region name => human readable name. |
| get_theme_name() X-Ref |
| Returns the human readable name of the theme return: string |
| get_block_render_method() X-Ref |
| Returns the block render method. It is set by the theme via: $THEME->blockrendermethod = '...'; It can be one of two values, blocks or blocks_for_region. It should be set to the method being used by the theme layouts. return: string |
Class: xhtml_container_stack - X-Ref
This class keeps track of which HTML tags are currently open.| __construct() X-Ref |
| Constructor |
| push($type, $closehtml) X-Ref |
| Push the close HTML for a recently opened container onto the stack. param: string $type The type of container. This is checked when {@link pop()} param: string $closehtml The HTML required to close the container. |
| pop($type) X-Ref |
| Pop the HTML for the next closing container from the stack. The $type must match the type passed when the container was opened, otherwise a warning will be output. param: string $type The type of container. return: string the HTML required to close the container. |
| pop_all_but_last($shouldbenone = false) X-Ref |
| Close all but the last open container. This is useful in places like error handling, where you want to close all the open containers (apart from <body>) before outputting the error message. param: bool $shouldbenone assert that the stack should be empty now - causes a return: string the HTML required to close any open containers inside <body>. |
| discard() X-Ref |
| You can call this function if you want to throw away an instance of this class without properly emptying the stack (for example, in a unit test). Calling this method stops the destruct method from outputting a developer debug warning. After calling this method, the instance can no longer be used. |
| log($action, $type) X-Ref |
| Adds an entry to the log. param: string $action The name of the action param: string $type The type of action |
| output_log() X-Ref |
| Outputs the log's contents as a HTML list. return: string HTML list of the log |
| theme_reset_all_caches() X-Ref |
| Invalidate all server and client side caches. This method deletes the physical directory that is used to cache the theme files used for serving. Because it deletes the main theme cache directory all themes are reset by this function. |
| theme_set_designer_mod($state) X-Ref |
| Enable or disable theme designer mode. param: bool $state |
| theme_get_revision() X-Ref |
| Returns current theme revision number. return: int |
| theme_is_device_locked($device) X-Ref |
| Checks if the given device has a theme defined in config.php. return: bool |
| theme_get_locked_theme_for_device($device) X-Ref |
| Returns the theme named defined in config.php for the given device. return: string or null |
| Generated: Thu Aug 11 10:00:09 2016 | Cross-referenced by PHPXref 0.7.1 |