README

Yii PowerPoint - Create and write presentations, with slides; slides are made up of text, images in PHP

QUICK START

You can see all examples and documentation:

  yiiAppPath/protected/vendor/alejandrososa/yii-power-point/samples
  yiiAppPath/protected/vendor/alejandrososa/yii-power-point/README.md

INSTALLATION

On command line, type in the following commands:

    $ cd yiiAppPath/protected              
    $ composer init && composer install                    (optional if not have composer.json)
    $ composer require alejandrososa/yii-power-point dev-master

Assuming that the vendor is installed in yiiAppPath/index.php

    // Include the vendor's autoloader:
    $vendor = dirname(__FILE__) . '/protected/vendor/autoload.php';
    require_once($vendor);

Now we import the vendor installed in the library main.php Edit the protected/config/main.php adding the following:

    //(optional path alias for images)
    Yii::setPathOfAlias('images', dirname(dirname(dirname(__FILE__))).'/images');
    
    return array(
        // autoloading model and component classes
        'import' => array(
            'application.vendor.*',
            ...
        )
        // application components
        'components'=>array(
            'ppt' => array(
                'class' => 'AlejandroSosa\\YiiPowerPoint\\PowerPoint'
            )
            ...
        )
    ),

USAGE

The first step in our controller is import Power Point class

    // in your Controller
    (use optional, only to call constants defined in PowerPoint)
    use AlejandroSosa\YiiPowerPoint\PowerPoint;
    
    class SiteController extends Controller {
        ...
    }

Now in your action

    /**
    * Create PPT
    */
    public function actionCreatePPT()
    {
        $options = [
            'fileName' => 'myFirstPPT',
            'fileProperties' => [
                'creator' => Yii::t('app', 'MyCompany'),
                'title' => Yii::t('app', 'State Budget 2016'),
                'subject' => Yii::t('app', 'Resumen General'),
                'description' => Yii::t('app', 'Any description')
            ],
            'layout' => [
                'background' => Yii::getPathOfAlias('images') .'/ppt/bg.png'
            ]
        ];

        $slides = [
            [
                'texts' => [
                    [
                        'text'=>Yii::t('app', 'Delivery'),
                        'options'=>[
                            'height'=>143, 'width'=>793, 'ox'=>120, 'oy'=>180,
                            'bold'=> true, 'size'=>44, 'color'=>PowerPoint::COLOR_CYAN,
                            'align'=>PowerPoint::TEXT_ALIGN_HORIZONTAL_CENTER,
                        ],
                    ],
                    [
                        'text'=>Yii::t('app', 'State Budget 2016'),
                        'options'=>[
                            'height'=>143, 'width'=>793, 'ox'=>170, 'oy'=>240,
                            'bold'=> false, 'size'=>40, 'color'=>PowerPoint::COLOR_BLUE,
                            'align'=>PowerPoint::TEXT_ALIGN_HORIZONTAL_CENTER,
                        ],
                    ] 
                ]
            ]
        ];
        
        Yii::app()->ppt->generate($options, $slides);
    }

SETTINGS OF CHARTS

General Purpose in options

Property	Definition	Type
height	height of the graph in pixels	integer
width	width of the graph in pixels	integer
ox	X coordinate, horizontal position on the slide	integer
oy	Y coordinate, vertical position on the slide	integer

IMAGES

Property	Definition	Type
options	Includes the following properties	array
path	Absolute path of the image	string
name	Name of the image (optional)	string
decription	Description of the image (optional)	string

TEXTS

Property	Definition	Type
text	Text you want to insert	string
options	Includes the following properties	array
align	Text alignment	string, you can access the constants from PowerPoint::TEXT_ALIGN_HORIZONTAL_CENTER
bold	Bold text	boolean, default is false
color	Text color	string, default is COLOR_PRIMARY_TEXT. You can access the constants from PowerPoint::COLOR_BLUE
size	Text size, default is 14	integer

TABLES

Property	Definition	Type
height	Height of the table in pixels	integer
width	Width of the table in pixels	integer
ox	X coordinate, horizontal position on the slide	integer
oy	Y coordinate, vertical position on the slide	integer
header	Row that represents the header of the table, array with the columns it contains	array
columns	Array of columns, contains text and column style	array
text	Text you want to insert into column	string
style	Includes the following properties into column,	array
background	Background color of column	string, default is COLOR_WHITE. You can access the constants from PowerPoint::COLOR_WHITE
height	Height of column in pixels	integer, default is 20
width	Width of colum in pixels	integer, default is 100
align	Text alignment of column	string default is center, you can access the constants from PowerPoint::TEXT_ALIGN_HORIZONTAL_CENTER
bold	Bold text of column	boolean, default is false
color	Text color of column	string, default is COLOR_PRIMARY_TEXT. You can access the constants from PowerPoint::COLOR_BLUE
size	Text size of column, default is 14	integer
borderWidth	Border width of column, default is 1	integer
borderColor	Border color of column, default is COLOR_GREY. You can access the constants from PowerPoint::COLOR_WHITE	string
rows	Row that represents the header of the table, array with the columns it contains	array
columns	Array of columns, contains text and column style or only text	array or string
style	Like the header, you can use the style properties in the rows at the general level for all rows	array

Nota: Styles can be applied at the general level for all rows or at a specific level for a column, you can see sample_tables

CHARTS

Property	Definition	Type
title	Title of chart	string
series	Array of data series composed of key and value array('2015'=>150)	array(string=>integer)
seriesTrends	Array of data series trends composed of key and value array('2015'=>150)	array(string=>integer)
options	Includes the following properties	array
type	Type of chart to create	string, you can access the constants from PowerPoint::TEXT_ALIGN_HORIZONTAL_CENTER
seriesName	Names of the data series, the name quantity must be equal to the number of data series	array
trendsName	Names of the data series trends, the name quantity must be equal to the number of data series	array
showSeriesName	Visibility of data series names, default is true	array
showTrendsName	Visibility of data series trends names, default is true	array
showPercente	Displays the percentages of the data series, default is true	boolean
showValue	Displays the values of the data series, default is true	boolean
showSymbol	Show symbol in data series, default is true. Only in Scatter	boolean
typeSymbol	Show symbol in data series, default is true. Only in Scatter	boolean
titleItalic	Title in italic format, default is false.	boolean
legendItalic	Title of legend in italic format, default is false.	boolean
legendBackground	Background color of legend	string, default is none. You can access the constants from PowerPoint::COLOR_WHITE
legendVisible	Show legend of data series, default is true.	boolean
legendOx	X coordinate of legend, horizontal position on the chart	integer
legendOy	Y coordinate of legend, vertical position on the chart	integer

Available the following type charts: CHART_TYPE_BAR, CHART_TYPE_BAR_HORIZONTAL, CHART_TYPE_BAR_STACKED, CHART_TYPE_BAR_PERCENT_STACKED, CHART_TYPE_BAR_3D, CHART_TYPE_BAR_TRENDLINE, CHART_TYPE_PIE, CHART_TYPE_PIE_3D, CHART_TYPE_SCATTER.

Available the following symbols in scatter: SYMBOL_CIRCLE, SYMBOL_DASH, SYMBOL_DIAMOND, SYMBOL_DOT, SYMBOL_NONE, SYMBOL_PLUS, SYMBOL_SQUARE, SYMBOL_STAR, SYMBOL_TRIANGLE, SYMBOL_X.

OTHER EXAMPLES

The other examples to create tables and graphs can be found in vendor/alejandrososa/yii-power-point/samples

WHAT'S NEXT

If you notice a bug, think about some improvement, then please write me

alejandrososa / yii-power-point

Maintainers

Details