Merge pull request #17 from lildude/modernising-phpzenfolio

Bring phpZenfolio into the 21st Century

Author: lildude

.editorconfig

@@ -0,0 +1,15 @@
+# This file is for unifying the coding style for different editors and IDEs
+# editorconfig.org
+
+# PHP PSR-2 Coding Standards
+# http://www.php-fig.org/psr/psr-2/
+
+root = true
+
+[*.php]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4

.gitignore

@@ -0,0 +1,5 @@
+vendor
+composer.lock
+composer.phar
+/build
+_site/

.travis.yml

@@ -0,0 +1,18 @@
+language: php
+sudo: true
+php:
+  - '5.6'
+  - '7.0'
+before_install:
+  # We need this because Zenfolio uses a Comodo/AddTrust certificate not trusted by default.
+  - echo -n | openssl s_client -connect api.zenfolio.com:443 | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' | sudo tee -a /etc/ssl/certs/ca-certificates.crt
+  - composer self-update
+
+install:
+  - composer install
+
+script:
+  - vendor/bin/phpunit -v
+
+after_script:
+  - vendor/bin/coveralls -v

CHANGELOG.md

@@ -0,0 +1,51 @@
+# Change Log
+All notable changes to this project will be documented in this file.
+As of 2.0.0, this project adheres to [Semantic Versioning](http://semver.org/) and the format is based on the suggestions a <http://keepachangelog.com/>.
+
+## [2.0.0] - 2016-10-16
+### Added
+- A new example showing how to create a gallery and upload an image to it.
+
+### Changed
+- Complete rewrite of phpZenfolio.
+- phpZenfolio 2.0.0 is _not_ backwardly compatible with phpZenfolio 1.x and earlier.
+- Implemented proper semantic versioning.
+- Switched to using Guzzle for requests to the API.  This means more reliable and predictable behaviour and allows for easier future improvements in phpZenfolio without having to worry about maintaining a library that submits requests.
+- All requests, except image uploads, use HTTPS. Zenfolio has not implemented image uploads over HTTPS yet.
+- Requires PHP 5.6.0 or later.
+- All tests are now public and run on Travis CI with every push.
+- Licensed under the MIT license.
+- Documentation has been split out of the README.md into individual files and moved to a dedicated directory.
+- All documentation is licensed under the CC BY 4.0 license.
+- PSR-1, PSR-2, and PSR-4 coding standards are implemented and enforced by unit testing.
+
+### Removed
+- Caching has been removed from phpZenfolio as there are better Guzzle-friendly implementations that tie-in with phpZenfolio thanks to the use of Guzzle.
+
+## [1.3] - 2016-04-16
+### Changed
+- Default API version is now 1.8 and the rest of the library takes this API version into account.
+- The README is Markdown instead of plaintext.
+
+## [1.2] - 2012-06-10
+### Added
+- Ability to perform ALL API requests over HTTPS (Ticket #4)
+
+### Changed
+- The API endpoint uses api.zenfolio.com as requested by Zenfolio
+- The default API version is now 1.6
+
+## [1.1] - 2011-03-28
+### Changed
+- Cache only successful requests
+- Improved connection settings
+
+### Fixed
+- Use md5 to generate a uniq ID for each request instead of using `intval()` to ensure correct and consistent behaviour on 32-bit and 64-bit platforms. (Ticket #1)
+- Corrected check for safe_dir OR open_basedir so fails over to socket connection correctly (Ticket #2)
+
+### Removed
+- Removed erroneous re-instantiation of processor when setting adapter.
+
+## [1.0] - 2010-10-01
+- Initial release.

CONTRIBUTING.md

@@ -0,0 +1,28 @@
+# Contributing to phpZenfolio
+
+## The Get Going Quick Guide
+
+1. Fork the phpZenfolio repository on [GitHub](https://github.com/lildude/phpZenfolio).
+2. If you're submitting a fix or improvement to the phpZenfolio code or submitting a new example, create a new branch from the `master` branch, for example: `your-fork/some-cool-feature` or `your-fork/fixing-something-broken` branch.
+3. If you're submitting a fix or improvement to the phpZenfolio website or documentation, create a new branch from the `gh-pages` branch.
+4. If you're submitting code changes, as opposed to documentation, write tests that fail without your changes and pass with them.
+5. Ensure all tests pass locally by running: `vendor/bin/phpunit` within your local clone of the repository.
+6. Submit a [pull request](https://help.github.com/articles/using-pull-requests/).
+
+All pull requests will be reviewed and will be merged once all tests have passed.
+
+# Coding Standards
+
+To try and keep things looking :sparkles:, please ensure your changes comply with the following coding standards:
+
+ * [PSR-1: Basic Coding Standard](http://www.php-fig.org/psr/psr-1/)
+ * [PSR-2: Coding Style Guide](http://www.php-fig.org/psr/psr-2/)
+ * [PSR-4: Improved Autoloading](http://www.php-fig.org/psr/psr-4/)
+
+All contributions are automatically checked against these standards using [php-cs-fixer](http://cs.sensiolabs.org/).
+
+# Licensing
+
+By contributing code you agree to license your contribution under the [MIT license](https://opensource.org/licenses/MIT).
+
+By contributing documentation, examples, or any other non-code assets you agree to license your contribution under the [CC BY 4.0 license](https://creativecommons.org/licenses/by/4.0/). Attribution shall be given according to the current bylaws of this group.