Merge branch 'MDL-73142-311' of https://github.com/susyzan/moodle into MOODLE_311_STABLE
[moodle.git] / lib / plist / README.md
blob1b16fddb58578505ce5e2d68b4b23597f9a1474f
1 # CFPropertyList
3 ![Teclib' Banner](https://user-images.githubusercontent.com/29282308/31669540-abed67a8-b355-11e7-98e2-0ad190f37088.png)
5 [![License MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE.md)
6 [![Follow twitter](https://img.shields.io/badge/Twitter-Teclib%27-940CA5.svg)](https://twitter.com/teclib)
7 [![Project Status: Active](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active)
8 [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org)
10 Teclib’ is an open source software editor that offers a vast range of fully integrated open source technology packages, to better respond to business needs.
12 Visit our Website [Teclib'](http://www.teclib-edition.com/en/).
14 ## Table of Contents
16 * [Synopsis](#synopsis)
17 * [Build Status](#build-status)
18 * [Installation](#installation)
19 * [Documentation](#documentation)
20 * [Versioning](#versioning)
21 * [Contact](#contact)
22 * [Contribute](#contribute)
23 * [Copying](#copying)
25 ## Synopsis
27 The PHP implementation of Apple's PropertyList can handle both XML and binary PropertyLists. It offers functionality to easily convert data between worlds, e.g. recalculating timestamps from unix epoch to apple epoch and vice versa. A feature to automagically create (guess) the plist structure from a normal PHP data structure will help you dump your data to plist in no time.
29 CFPropertyList does not rely on any "Apple proprietary" components, like plutil. CFPropertyList runs on any Operating System with PHP and some standard extensions installed.
31 Although you might want to deliver data to your iPhone application, you might want to run those server side services on your standard Linux (or even Windows) environment, rather than buying an expensive Apple Server. With CFPropertyList you now have the power to provide data from your favorite Operating System.
33 ## Build Status
35 |**Release channel**|Beta Channel|
36 |:---:|:---:|
37 |[![Travis CI build](https://api.travis-ci.org/TECLIB/CFPropertyList.svg?branch=master)](https://travis-ci.org/TECLIB/CFPropertyList)|[![Travis CI build](https://api.travis-ci.org/TECLIB/CFPropertyList.svg?branch=develop)](https://travis-ci.org/TECLIB/CFPropertyList)|
39 ## Installation
41 See or [How to install article](https://teclib.github.io/CFPropertyList/howtos/installation).
43 ## Documentation
45 We maintain a detailed documentation of the project on the Website, check the Development [Development](https://teclib.github.io/CFPropertyList/) and [How-tos](https://teclib.github.io/CFPropertyList/howtos) sections.
47 ## Versioning
49 In order to provide transparency on our release cycle and to maintain backward compatibility, Flyve MDM is maintained under [the Semantic Versioning guidelines](http://semver.org/). We are committed to following and complying with the rules, the best we can.
51 See [the tags section of our GitHub project](https://github.com/TECLIB/CFPropertyList/tags) for changelogs for each release version. Release announcement posts on [the official Teclib' blog](http://www.teclib-edition.com/en/communities/blog-posts/) contain summaries of the most noteworthy changes made in each release.
53 ## Contact
55 You can contact us through any of our channels, check our [Contact section](http://www.teclib-edition.com/en/contact-us/)
57 ## Contribute
59 Want to file a bug, contribute some code, or improve documentation? Excellent! Read up on our
60 guidelines for [contributing](./CONTRIBUTING.md) and then check out one of our issues in the [Issues Dashboard](https://github.com/TECLIB/CFPropertyList/issues).
62 ## Copying
64 * **Code**: you can redistribute it and/or modify
65     it under the terms of the MIT License ([MIT](https://opensource.org/licenses/MIT)).
66 * **Documentation**: released under Attribution 4.0 International ([CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)).