docs/index.md
#
PHPPresentation is a library written in pure PHP that provides a set of
classes to write to different presentation file formats, i.e.
[Microsoft Office Open XML](http://en.wikipedia.org/wiki/Office_Open_XML)
(`.pptx`) and OASIS [Open Document Format for Office Applications](http://en.wikipedia.org/wiki/OpenDocument) (`.odp`).
PHPPresentation is an open source project licensed under the terms of [LGPL
version 3](https://github.com/PHPOffice/PHPPresentation/blob/develop/COPYING.LESSER).
PHPPresentation is aimed to be a high quality software product by incorporating
[continuous integration and unit testing](https://github.com/PHPOffice/PHPPresentation/actions/workflows/php.yml).
You can learn more about PHPPresentation by reading this Developers'
Documentation.
<!---
- and the `API Documentation <http://phpoffice.github.io/PHPPresentation/docs/develop/>`__
-->
## Features
- Create an in-memory presentation representation
- Set presentation meta data (author, title, description, etc)
- Add slides from scratch or from existing one
- Supports different fonts and font styles
- Supports different formatting, styles, fills, gradients
- Supports hyperlinks and rich-text strings
- Add images with different styles (positioning, rotation, shadow)
- Set printing options (header, footer, page margins, paper size, orientation)
- Input from different file formats:
- PowerPoint 97 (.ppt)
- PowerPoint 2007 (.pptx)
- OpenDocument Presentation (.odp)
- Serialized Spreadsheet
- Output to different file formats:
- PowerPoint 2007 (.pptx)
- OpenDocument Presentation (.odp)
- Serialized Spreadsheet
- ... and lots of other things!
## File formats
Below are the supported features for each file formats.
### Writers
| Features | | HTML | ODP | PDF | PPTX |
|---------------------------|----------------------|-------|-------|-------|-------|
| **Document** | Mark as final | | | | :material-check: |
| **Document Properties** | Standard | | :material-check: | | :material-check: |
| | Custom | | :material-check: | | :material-check: |
| **Slides** | | | :material-check: | | :material-check: |
| | Name | | :material-check: | | |
| **Element Shape** | AutoShape | | | | :material-check: |
| | Image | | :material-check: | | :material-check: |
| | Hyperlink | | :material-check: | | :material-check: |
| | Line | | :material-check: | | :material-check: |
| | MemoryImage | | :material-check: | | :material-check: |
| | RichText | | :material-check: | | :material-check: |
| | Table | | :material-check: | | :material-check: |
| | Text | | :material-check: | | :material-check: |
| **Charts** | Area | | :material-check: | | :material-check: |
| | Bar | | :material-check: | | :material-check: |
| | Bar3D | | :material-check: | | :material-check: |
| | Doughnut | | :material-check: | | :material-check: |
| | Line | | :material-check: | | :material-check: |
| | Pie | | :material-check: | | :material-check: |
| | Pie3D | | :material-check: | | :material-check: |
| | Radar | | :material-check: | | :material-check: |
| | Scatter | | :material-check: | | :material-check: |
### Readers
| Features | | ODP | PPT | PPTX |
|---------------------------|----------------------|-------|-------|-------|
| **Document** | Mark as final | | | :material-check: |
| **Document Properties** | Standard | :material-check: | | :material-check: |
| | Custom | :material-check: | | :material-check: |
| **Slides** | | :material-check: | | :material-check: |
| | Name | | | |
| **Element Shape** | AutoShape | | | |
| | Image | :material-check: | :material-check: | :material-check: |
| | Hyperlink | :material-check: | :material-check: | :material-check: |
| | RichText | :material-check: | :material-check: | :material-check: |
| | Table | | | |
| | Text | :material-check: | :material-check: | :material-check: |
| **Charts** | Area | | | |
| | Bar | | | |
| | Bar3D | | | |
| | Doughnut | | | |
| | Line | | | |
| | Pie | | | |
| | Pie3D | | | |
| | Radar | | | |
| | Scatter | | | |
## Contributing
We welcome everyone to contribute to PHPPresentation. Below are some of the things that you can do to contribute:
- Read [our contributing guide](https://github.com/PHPOffice/PHPPresentation/blob/master/CONTRIBUTING.md)
- [Fork us](https://github.com/PHPOffice/PHPPresentation/fork) and [request a pull](https://github.com/PHPOffice/PHPPresentation/pulls) to the [develop](https://github.com/PHPOffice/PHPPresentation/tree/develop) branch
- Submit [bug reports or feature requests](https://github.com/PHPOffice/PHPPresentation/issues) to GitHub
- Follow [@PHPOffice](https://twitter.com/PHPOffice) on Twitter