[![Code Coverage](https://scrutinizer-ci.com/g/easydigitaldownloads/Easy-Digital-Downloads/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/easydigitaldownloads/Easy-Digital-Downloads/?branch=master) [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/bearded-avenger/aesop-core/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/bearded-avenger/aesop-core/?branch=master)  [![License](https://img.shields.io/badge/license-GPL--2.0%2B-red.svg?style=flat-square)](http://www.gnu.org/licenses/gpl-2.0.html) [![Tool](https://img.shields.io/badge/wp--translations-used-brightgreen.svg?style=flat-square)](http://wp-translations.org)

# Aesop Story Engine
Aesop Story Engine is an open-sourced suite of tools that empower developers to build feature-rich, interactive, long-form stories within Wordpress. ASE is the same engine that drives the storytelling experience through our hosted platform at [Story.AM](https://story.am).

---

### Installation
##### Uploading in WordPress Dashboard

1. Navigate to 'Add New' in the plugins dashboard  
2. Navigate to the 'Upload' area  
3. Select `aesop-core.zip` from your computer  
4. Click 'Install Now'  
5. Activate the plugin in the Plugin dashboard

##### Using FTP  

1. Download `aesop-core.zip`  
2. Extract the `aesop-core` directory to your computer  
3. Upload the `aesop-core` directory to the `/wp-content/plugins/` directory  
4. Activate the plugin in the Plugin dashboard

---

##### Documentation
[http://aesopstoryengine.com/developers](http://aesopstoryengine.com/developers/)  

---

##### Bugs
If you find an issue, please let us know [here](https://github.com/bearded-avenger/aesop-core/issues?state=open)!

---

##### Support
This is a developer's portal for Aesop Story Engine and should _not_ be used for support. Please visit our [support forums](https://wordpress.org/support/plugin/aesop-story-engine).

---

##### Contributions
Contributions are more than welcome. Please read our current [guidelines for contributing](https://github.com/bearded-avenger/aesop-core/blob/master/CONTRIBUTING.md) to this repository. Many thanks in advance!

---

### Story Components
At the heart of ASE are the storytelling components. They include:  
* Audio  
* Video  
* Content  
* Character  
* Gallery
* Chapter Heading  
* Image  
* Location  
* Parallax  
* Quote  
* Timeline  
* Collection  
* Document Viewer  

Interactive elements are created while crafting stories, with the Story Component Creator.
![Image](https://dl.dropboxusercontent.com/u/5594632/ase-screenshot.png)

---

### Changelog
See [https://github.com/bearded-avenger/aesop-core/releases](https://github.com/bearded-avenger/aesop-core/releases) for more.

---

### Translations
Aesop Story Engine is currently available in 35 languages. We work closely with the folks over at WP Translations, and it's because of them that these translations are available.

* العربية (Arabic)
* Български (Bulgarian)
* Burmese (Myanmar)
* čeština‎ (Czech)
* 中文 (Chinese (China))
* Dansk (Danish (Denmark))
* Nederlands (Dutch)
* English (United Kingdom)
* English (US)
* Suomi (Finnish)
* Français (French (France))
* Deutsch (German)
* Ελληνικά (Greek)
* עִבְרִית (Hebrew)
* Magyar (Hungarian)
* Indonesian (Indonesia)
* Italiano (Italian)
* 日本語 (Japanese)
* ភាសាខ្មែរ (Khmer)
* 한국어 (Korean)
* Bokmål (Norwegian)
* فارسی (Persian)
* Polski (Polish)
* Português do Brasil (Portuguese (Brazil))
* Română (Romanian)
* Русский (Russian)
* Српски језик (Serbian)
* Slovenčina (Slovak)
* slovenščina (Slovenian)
* Español (Spanish (Argentina))
* Español (Spanish (Mexico))
* Español (Spanish (Spain))
* ไทย (Thai)
* Türkçe (Turkish)
* Tiếng Việt (Vietnamese)

---

### Demo Theme  
Here is a basic sample WordPress theme showing implementation of the story engine component design: [Aesop Story Theme](https://github.com/AesopInteractive/aesop-story-theme).