API for developers

We <3 people who code.

1. Folder structure
2. Objects
2.1. Yellow page
2.2. Yellow page collection
2.3. Yellow content
2.4. Yellow media
2.5. Yellow system
2.6. Yellow text
2.7. Yellow toolbox
2.8. Yellow extensions
3. Events
3.1. Yellow core events
3.2. Yellow edit events
3.3. Yellow command events

Folder structure

The following folders are available:

├── content               = content files
│   ├── 1-home            = home page
│   └── shared            = shared files
├── media                 = media files
│   ├── downloads         = files to download
│   ├── images            = image files for the content
│   └── thumbnails        = image thumbnails
└── system                = system files
    ├── extensions        = extension files
    ├── layouts           = layout files, HTML files
    ├── settings          = configuration files, INI files
    ├── themes            = theme files, CSS files, fonts, etc.
    └── trash             = deleted files

Objects

The following objects are available:

$this->yellow->page = access to current page
$this->yellow->content = access to content files from file system
$this->yellow->media = access to media files from file system
$this->yellow->system = access to system settings
$this->yellow->text = access to text settings
$this->yellow->toolbox = access to toolbox with helpers
$this->yellow->extensions = access to features and themes

Yellow page

Yellow page gives access to current page:

$this->yellow->page->get($key)
Return page setting

$this->yellow->page->getHtml($key)
Return page setting, HTML encoded

$this->yellow->page->getDate($key, $format = "")
Return page setting as language specific date format

$this->yellow->page->getDateHtml($key, $format = "")
Return page setting as language specific date format, HTML encoded

$this->yellow->page->getDateRelative($key, $format = "", $daysLimit = 30)
Return page setting as language specific date format, relative to today

$this->yellow->page->getDateRelativeHtml($key, $format = "", $daysLimit = 30)
Return page setting as language specific date format, relative to today, HTML encoded

$this->yellow->page->getDateFormatted($key, $format)
Return page setting with custom date format

$this->yellow->page->getDateFormattedHtml($key, $format)
Return page setting with custom date format, HTML encoded

$this->yellow->page->getContent($rawFormat = false, $sizeMax = 0)
Return page content, HTML encoded or raw format

$this->yellow->page->getParent()
Return parent page, null if none

$this->yellow->page->getParentTop($homeFallback = false)
Return top-level parent page, null if none

$this->yellow->page->getSiblings($showInvisible = false)
Return page collection with pages on the same level

$this->yellow->page->getChildren($showInvisible = false)
Return page collection with child pages

$this->yellow->page->getPages()
Return page collection with additional pages

$this->yellow->page->getPage($key)
Return related page

$this->yellow->page->getUrl()
Return page URL

$this->yellow->page->getBase($multiLanguage = false)
Return page base

$this->yellow->page->getLocation($absoluteLocation = false)
Return page location

$this->yellow->page->getRequest($key)
Return page request argument

$this->yellow->page->getRequestHtml($key)
Return page request argument, HTML encoded

$this->yellow->page->getHeader($key)
Return page response header

$this->yellow->page->getExtra($name)
Return page extra data

$this->yellow->page->getModified($httpFormat = false)
Return page modification date, Unix time or HTTP format

$this->yellow->page->getLastModified($httpFormat = false)
Return last modification date, Unix time or HTTP format

$this->yellow->page->getStatusCode($httpFormat = false)
Return page status code, number or HTTP format

$this->yellow->page->error($statusCode, $pageError = "")
Respond with error page

$this->yellow->page->clean($statusCode, location = "")
Respond with status code, no page content

$this->yellow->page->isAvailable()
Check if page is available

$this->yellow->page->isVisible()
Check if page is visible

$this->yellow->page->isActive()
Check if page is within current HTTP request

$this->yellow->page->isCacheable()
Check if page is cacheable

$this->yellow->page->isError()
Check if page with error

$this->yellow->page->isExisting($key)
Check if page setting exists

$this->yellow->page->isRequest($key)
Check if request argument exists

$this->yellow->page->isHeader($key)
Check if response header exists

$this->yellow->page->isPage($key)
Check if related page exists

Here's an example layout for showing page content:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<?php echo $this->yellow->page->getContent() ?>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Here's an example layout for showing page content with additional setting:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<p><?php echo $this->yellow->page->getHtml("author") ?></p>
<?php echo $this->yellow->page->getContent() ?>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Here's an example layout for showing page content with additional date:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<p><?php echo $this->yellow->page->getDateHtml("modified", "coreDateFormatMedium") ?></p>
<?php echo $this->yellow->page->getContent() ?>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Yellow page collection

Yellow page collection gives access to multiple pages:

$pages->filter($key, $value, $exactMatch = true)
Filter page collection by setting

$pages->match($regex = "/.*/")
Filter page collection by file name

$pages->sort($key, $ascendingOrder = true)
Sort page collection by setting

$pages->similar($page, $ascendingOrder = false)
Sort page collection by settings similarity

$pages->merge($input)
Calculate union, merge page collection

$pages->intersect($input)
Calculate intersection, remove pages that are not present in another page collection

$pages->diff($input)
Calculate difference, remove pages that are present in another page collection

$pages->append($page)
Append to end of page collection

$pages->prepend($page)
Prepend to start of page collection

$pages->limit($pagesMax)
Limit the number of pages in page collection

$pages->reverse()
Reverse page collection

$pages->shuffle()
Randomize page collection

$pages->pagination($limit, $reverse = true)
Paginate page collection

$pages->getPaginationNumber()
Return current page number in pagination

$pages->getPaginationCount()
Return highest page number in pagination

$pages->getPaginationLocation($absoluteLocation = true, $pageNumber = 1)
Return location for a page in pagination

$pages->getPaginationPrevious($absoluteLocation = true)
Return location for previous page in pagination

$pages->getPaginationNext($absoluteLocation = true)
Return location for next page in pagination

$pages->getPagePrevious($page)
Return previous page in collection, null if none

$pages->getPageNext($page)
Return next page in collection, null if none

$pages->getFilter()
Return current page filter

$pages->getModified($httpFormat = false)
Return page collection modification date, Unix time or HTTP format

$pages->isPagination()
Check if there is a pagination

Here's an example layout for showing three random pages:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<?php $pages = $this->yellow->content->index()->shuffle()->limit(3) ?>
<?php $this->yellow->page->setLastModified($pages->getModified()) ?>
<ul>
<?php foreach ($pages as $page): ?>
<li><?php echo $page->getHtml("title") ?></li>
<?php endforeach ?>
</ul>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Here's an example layout for showing latest pages:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<?php $pages = $this->yellow->content->index()->sort("modified", false) ?>
<?php $this->yellow->page->setLastModified($pages->getModified()) ?>
<ul>
<?php foreach ($pages as $page): ?>
<li><?php echo $page->getHtml("title") ?></li>
<?php endforeach ?>
</ul>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Here's an example layout for showing draft pages:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<?php $pages = $this->yellow->content->index(true, true)->filter("status", "draft") ?>
<?php $this->yellow->page->setLastModified($pages->getModified()) ?>
<ul>
<?php foreach ($pages as $page): ?>
<li><?php echo $page->getHtml("title") ?></li>
<?php endforeach ?>
</ul>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Yellow content

Yellow content gives access to content files from file system:

$this->yellow->content->find($location, $absoluteLocation = false)
Return page from file system, null if not found

$this->yellow->content->index($showInvisible = false, $multiLang = false, $levelMax = 0)
Return page collection with all pages

$this->yellow->content->top($showInvisible = false, $showOnePager = true)
Return page collection with top-level navigation

$this->yellow->content->path($location, $absoluteLocation = false)
Return page collection with path ancestry

$this->yellow->content->multi($location, $absoluteLocation = false, $showInvisible = false)
Return page collection with multiple languages in multi language mode

$this->yellow->content->shared($name)
Return page with shared content, null if not found

$this->yellow->content->clean()
Return page collection that is empty

Here's an example layout for showing all pages:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<?php $pages = $this->yellow->content->index(true, true) ?>
<?php $this->yellow->page->setLastModified($pages->getModified()) ?>
<ul>
<?php foreach ($pages as $page): ?>
<li><?php echo $page->getHtml("title") ?></li>
<?php endforeach ?>
</ul>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Here's an example layout for showing pages below a specific location:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<?php $pages = $this->yellow->content->find("/help/")->getChildren(true) ?>
<?php $this->yellow->page->setLastModified($pages->getModified()) ?>
<ul>
<?php foreach ($pages as $page): ?>
<li><?php echo $page->getHtml("title") ?></li>
<?php endforeach ?>
</ul>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Here's an example layout for showing top-level navigation pages:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<?php $pages = $this->yellow->content->top() ?>
<?php $this->yellow->page->setLastModified($pages->getModified()) ?>
<ul>
<?php foreach ($pages as $page): ?>
<li><?php echo $page->getHtml("titleNavigation") ?></li>
<?php endforeach ?>
</ul>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Yellow media

Yellow media gives access to media files from file system:

$this->yellow->media->find($location, $absoluteLocation = false)
Return page with media file information, null if not found

$this->yellow->media->index($showInvisible = false, $multiPass = false, $levelMax = 0)
Return page collection with all media files

$this->yellow->media->clean()
Return page collection that is empty

Here's an example layout for showing all media files:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<?php $files = $this->yellow->media->index(true) ?>
<?php $this->yellow->page->setLastModified($files->getModified()) ?>
<ul>
<?php foreach ($files as $file): ?>
<li><?php echo $file->getLocation(true) ?></li>
<?php endforeach ?>
</ul>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Here's an example layout for showing latest media files:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<?php $files = $this->yellow->media->index(true)->sort("modified", false) ?>
<?php $this->yellow->page->setLastModified($files->getModified()) ?>
<ul>
<?php foreach ($files as $file): ?>
<li><?php echo $file->getLocation(true) ?></li>
<?php endforeach ?>
</ul>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Here's an example layout for showing media files of a specific type:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<?php $files = $this->yellow->media->index(true)->filter("type", "pdf") ?>
<?php $this->yellow->page->setLastModified($files->getModified()) ?>
<ul>
<?php foreach ($files as $file): ?>
<li><?php echo $file->getLocation(true) ?></li>
<?php endforeach ?>
</ul>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Yellow system

Yellow system gives access to system settings:

$this->yellow->system->get($key)
Return system setting

$this->yellow->system->getHtml($key)
Return system setting, HTML encoded

$this->yellow->system->getData($filterStart = "", $filterEnd = "")
Return system settings

$this->yellow->system->getModified($httpFormat = false)
Return system settings modification date, Unix time or HTTP format

$this->yellow->system->isExisting($key)
Check if system setting exists

Here's an example layout for showing static website settings:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<p>
<?php foreach ($this->yellow->system->getData("static") as $key=>$value): ?>
<?php echo htmlspecialchars("$key: $value") ?><br />
<?php endforeach ?>
</p>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Here's an example layout for showing webmaster settings:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<p>
<?php echo "Author: ".$this->yellow->system->getHtml("author")."<br />" ?>
<?php echo "Email: ".$this->yellow->system->getHtml("email")."<br />" ?>
</p>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Here's an example layout for showing if multi language mode is activated:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<p>
<?php $multiLanguageMode = $this->yellow->system->get("coreMultiLanguageMode") ?>
Multi language mode is <?php echo htmlspecialchars($multiLanguageMode ? "on" : "off") ?>.
</p>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Yellow text

Yellow text gives access to text settings:

$this->yellow->text->get($key)
Return text setting

$this->yellow->text->getHtml($key)
Return text setting, HTML encoded

$this->yellow->text->getText($key, $language )
Return text setting for specific language

$this->yellow->text->getTextHtml($key, $language )
Return text setting for specific language, HTML encoded

$this->yellow->text->getData($filterStart = "", $language = "")
Return text settings

$this->yellow->text->getModified($httpFormat = false)
Return text settings modification date, Unix time or HTTP format

$this->yellow->text->getLanguages()
Return languages

$this->yellow->text->isLanguage($language)
Check if language exists

$this->yellow->text->isExisting($key, $language = "")
Check if text setting exists

Here's an example layout for showing error messages:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<p>
<?php foreach ($this->yellow->text->getData("error") as $key=>$value): ?>
<?php echo htmlspecialchars("$key: $value") ?><br />
<?php endforeach ?>
</p>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Here's an example layout for showing languages and translators:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<p>
<?php foreach ($this->yellow->text->getLanguages() as $language): ?>
<?php echo $this->yellow->text->getTextHtml("languageDescription", $language) ?> - 
<?php echo $this->yellow->text->getTextHtml("languageTranslator", $language) ?><br />
<?php endforeach ?>
</p>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Here's an example layout for checking if a specific language exists:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<?php $swedish = $this->yellow->text->isLanguage("sv") ?>
<p>Swedish language <?php echo htmlspecialchars($swedish ? "" : "not") ?> installed.</p>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Yellow toolbox

Yellow toolbox gives access to toolbox with helpers:

$this->yellow->toolbox->getCookie($key)
Return browser cookie from from current HTTP request

$this->yellow->toolbox->getServer($key)
Return server argument from current HTTP request

$this->yellow->toolbox->normaliseArguments($text, $appendSlash = true, $filterStrict = true)
Normalise location arguments

$this->yellow->toolbox->getDirectoryEntries($path, $regex = "/.*/", $sort = true, $directories = true, $includePath = true)
Return files and directories

$this->yellow->toolbox->readFile($fileName, $sizeMax = 0)
Read file, empty string if not found

$this->yellow->toolbox->createFile($fileName, $fileData, $mkdir = false)
Create file

$this->yellow->toolbox->appendFile($fileName, $fileData, $mkdir = false)
Append file

$this->yellow->toolbox->copyFile($fileNameSource, $fileNameDestination, $mkdir = false)
Copy file

$this->yellow->toolbox->renameFile($fileNameSource, $fileNameDestination, $mkdir = false)
Rename file

$this->yellow->toolbox->renameDirectory($pathSource, $pathDestination, $mkdir = false)
Rename directory

$this->yellow->toolbox->deleteFile($fileName, $pathTrash = "")
Delete file

$this->yellow->toolbox->deleteDirectory($path, $pathTrash = "")
Delete directory

$this->yellow->toolbox->modifyFile($fileName, $modified)
Set file modification date, Unix time

$this->yellow->toolbox->getFileModified($fileName)
Return file modification date, Unix time

$this->yellow->toolbox->getTextLines($text)
Return lines from text string, including newline

$this->yellow->toolbox->getTextList($text, $separator, $size)
Return array of specific size from text string

$this->yellow->toolbox->getTextArguments($text, $optional = "-", $sizeMin = 9)
Return arguments from text string, space separated

Here's an example layout for showing files in a directory:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<p>
<?php $path = $this->yellow->system->get("coreSettingDirectory") ?>
<?php foreach ($this->yellow->toolbox->getDirectoryEntries($path, "/.*/", true, false) as $entry): ?>
<?php echo htmlspecialchars($entry) ?><br />
<?php endforeach ?>
</p>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Here's an example layout for reading text lines from file:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<p>
<?php $fileName = $this->yellow->system->get("coreSettingDirectory").$this->yellow->system->get("coreSystemFile") ?>
<?php $fileData = $this->yellow->toolbox->readFile($fileName) ?>
<?php foreach ($this->yellow->toolbox->getTextLines($fileData) as $line): ?>
<?php echo htmlspecialchars($line) ?><br />
<?php endforeach ?>
</p>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Yellow extensions

Yellow extensions gives access to features and themes:

$this->yellow->extensions->get($name)
Return extension

$this->yellow->extensions->getData($type = "")
Return extensions version

$this->yellow->extensions->getModified($httpFormat = false)
Return extensions modification date, Unix time or HTTP format

$this->yellow->extensions->getExtensions($type = "")
Return extensions

$this->yellow->extensions->isExisting($name)
Check if extension exists

Here's an example layout for showing information about extensions:

<?php $this->yellow->layout("header") ?>
<div class="content">
<div class="main" role="main">
<h1><?php echo $this->yellow->page->getHtml("titleContent") ?></h1>
<p>
<?php foreach($this->yellow->extensions->getData() as $key=>$value): ?>
<?php echo htmlspecialchars("$key $value") ?><br />
<?php endforeach ?>
</p>
</div>
</div>
<?php $this->yellow->layout("footer") ?>

Here's an example extension for creating own features:

<?php
class YellowExample {
    const VERSION = "0.1.0";
    const TYPE = "feature";
}

Here's an example extension for creating own themes:

<?php
class YellowExample {
    const VERSION = "0.1.0";
    const TYPE = "theme";
}

Events

The following events are available in extensions:

onLoad ───────▶ onStartup ─────────────────────────────────────────┐
                    │                                              │
                    ▼                                              │
                onRequest ─────────────────┐                       │
                    │                      │                       │
                    ▼                      ▼                       ▼
                onParseMeta             onEditContentFile      onCommand
                onParseContentRaw       onEditMediaFile        onCommandHelp
                onParseContentShortcut  onEditSystemFile           │
                onParseContentText      onEditUserAccount          │
                onParsePageLayout          │                       ▼
                onParsePageExtra           │                   onLog
                onParsePageOutput          │                   onUpdate
                    │                      │                       │
                    ▼                      │                       │
exit ◀───────── onShutDown ◀───────────────┴───────────────────────┘

When a page is displayed, the extensions are loaded and onLoad will be called. As soon as all extensions are loaded onStartup will be called. After that the core informs with onRequest that there's a request. The page can be analysed with various onParse events. Then the page content will be generated. If an error occurs, an error page will be generated. Finally the page is output and onShutdown will be called.

When a page is edited, the extensions are loaded and onLoad will be called. As soon as all extensions are loaded onStartup will be called. After that the core informs with onRequest that there's a request, which will be handled by the edit extension. Changes at the page can be analysed with various onEdit events. Then the page will be saved in the file system. Finally a status code is output to reload the page and onShutdown will be called.

When a command is executed, the extensions are loaded and onLoad will be called. As soon as all extensions are loaded onStartup will be called. After that the core informs with onCommand that there's a command, which will be handled by the corresponding extension. If no command has been entered at the command line, then onCommandHelp will be called and extensions can provide a help. Finally a return code is output and onShutdown will be called.

Yellow core events

Yellow core events notify when a state has changed.

public function onLoad($yellow)
Handle initialisation

public function onStartup()
Handle startup

public function onRequest($scheme, $address, $base, $location, $fileName)
Handle request

public function onParseMeta($page)
Handle page meta data

public function onParseContentRaw($page, $text)
Handle page content in raw format

public function onParseContentShortcut($page, $name, $text, $type)
Handle page content of shortcut

public function onParseContentText($page, $text)
Handle page content

public function onParsePageLayout($page, $name)
Handle page layout

public function onParsePageExtra($page, $name)
Handle page extra data

public function onParsePageOutput($page, $text)
Handle page output data

public function onLog($action, $message)
Handle logging

public function onUpdate($action)
Handle update

public function onShutdown()
Handle shutdown

Here's an example extension for handling an [example] shortcut:

<?php
class YellowExample {
    const VERSION = "0.1.1";
    const TYPE = "feature";
    public $yellow;         //access to API

    // Handle initialisation
    public function onLoad($yellow) {
        $this->yellow = $yellow;
    }

    // Handle page content of shortcut
    public function onParseContentShortcut($page, $name, $text, $type) {
        $output = null;
        if ($name=="example" && ($type=="block" || $type=="inline")) {
            $output = "<div class=\"".htmlspecialchars($name)."\">";
            $output .= "Add more HTML code here";
            $output .= "</div>";
        }
        return $output;
    }
}

Yellow edit events

Yellow edit events notify when a page is edited in the web browser.

public function onEditContentFile($page, $action)
Handle content file changes

public function onEditMediaFile($file, $action)
Handle media file changes

public function onEditSystemFile($file, $action)
Handle system file changes

public function onEditUserAccount($email, $password, $action, $users)
Handle user account changes

Here's an example extension for handling a file:

<?php
class YellowExample {
    const VERSION = "0.1.3";
    const TYPE = "feature";
    public $yellow;         //access to API

    // Handle initialisation
    public function onLoad($yellow) {
        $this->yellow = $yellow;
    }

    // Handle media file changes
    public function onEditMediaFile($file, $action) {
        if ($action=="upload") {
            $fileName = $file->fileName;
            $fileType = $this->yellow->toolbox->getFileType($file->get("fileNameShort"));
            // Add more PHP code here
        }
    }
}

Yellow command events

Yellow command events notify when a command is executed.

public function onCommand($command, $text)
Handle command

public function onCommandHelp()
Handle command help

Here's an example extension for handling a command:

<?php
class YellowExample {
    const VERSION = "0.1.2";
    const TYPE = "feature";
    public $yellow;         //access to API

    // Handle initialisation
    public function onLoad($yellow) {
        $this->yellow = $yellow;
    }

    // Handle command help
    public function onCommandHelp() {
        return "example\n";
    }

    // Handle command
    public function onCommand($command, $text) {
        $statusCode = 0;
        if ($command=="example") {
            echo "Yellow $command: Add more text here\n";
            $statusCode = 200;
        }
        return $statusCode;
    }
}