PHP Classes

File: src/Plugin/Package.php

Recommend this page to a friend!
  Classes of Thierry Feuzeu   Jaxon   src/Plugin/Package.php   Download  
File: src/Plugin/Package.php
Role: Class source
Content type: text/plain
Description: Class source
Class: Jaxon
Call PHP classes from JavaScript using AJAX
Author: By
Last change: New method in the Package class.
Added a html() alias method in the Package class.
Date: 2 years ago
Size: 3,157 bytes
 

Contents

Class file image Download
<?php

/**
 * Generator.php - Code generator interface
 *
 * Any class generating css or js code must implement this interface.
 *
 * @package jaxon-core
 * @author Thierry Feuzeu <thierry.feuzeu@gmail.com>
 * @license https://opensource.org/licenses/BSD-3-Clause BSD 3-Clause License
 * @link https://github.com/jaxon-php/jaxon-core
 */

namespace Jaxon\Plugin;

use
Jaxon\Utils\Config\Config;

abstract class
Package implements Code\Contracts\Generator
{
   
/**
     * The configuration options of the package
     *
     * @var array
     */
   
protected $aOptions = [];

   
/**
     * The configuration options of the package
     *
     * @var Config
     */
   
protected $xConfig;

   
/**
     * Whether to include the getReadyScript() in the generated code.
     *
     * @var boolean
     */
   
protected $bReadyEnabled = false;

   
/**
     * Get the package options in an array.
     *
     * @return array
     */
   
public function getOptions()
    {
        return
$this->aOptions;
    }

   
/**
     * Get the package options in a Config object.
     *
     * @return Config
     */
   
public function getConfig()
    {
        return
$this->xConfig;
    }

   
/**
     * Get the value of a given package option
     *
     * @param string $sOption The option name
     * @param mixed $xDefault The default value
     *
     * @return mixed
     */
   
public function getOption($sOption, $xDefault = null)
    {
        return
$this->getConfig()->getOption((string)$sOption, $xDefault);
    }

   
/**
     * Get the view renderer
     *
     * @return \Jaxon\Utils\View\Renderer
     */
   
public function view()
    {
        return
jaxon()->view();
    }

   
/**
     * Get the path to the config file
     *
     * @return string
     */
   
abstract public static function getConfigFile();

   
/**
     * Include the getReadyScript() in the generated code.
     *
     * @return void
     */
   
public function ready()
    {
       
$this->bReadyEnabled = true;
    }

   
/**
     * @inheritDoc
     */
   
public function readyEnabled()
    {
        return
$this->bReadyEnabled;
    }

   
/**
     * @inheritDoc
     */
   
public final function readyInlined()
    {
       
// For packages, the getReadyScript() is never exported to external files.
       
return true;
    }

   
/**
     * @inheritDoc
     */
   
public final function getHash()
    {
       
// Packages do not generate hash on their own. So we make this method final.
       
return '';
    }

   
/**
     * @inheritDoc
     */
   
public function getCss()
    {
        return
'';
    }

   
/**
     * @inheritDoc
     */
   
public function getJs()
    {
        return
'';
    }

   
/**
     * @inheritDoc
     */
   
public function getScript()
    {
        return
'';
    }

   
/**
     * Get the HTML code of the package home page
     *
     * @return string
     */
   
abstract public function getHtml();

   
/**
     * Get the HTML code of the package home page
     *
     * This method is an alias for getHtml().
     *
     * @return string
     */
   
public function html()
    {
        return
$this->getHtml();
    }
}