[![Build Status](https://scrutinizer-ci.com/g/bearded-avenger/aesop-core/badges/build.png?b=release%2F1.5.1)](https://scrutinizer-ci.com/g/bearded-avenger/aesop-core/build-status/release/1.5.1)[![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)
# Description
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/)  

---

### 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 30 languages. We work closely with the folks over at WP Translations, and it's because of them that these translations are available.
* Български (Bulgarian)
* čeština‎ (Czech)
* 中文 (Chinese (China))
* Dansk (Danish)
* Nederlands (Dutch)
* English (US)
* Suomi (Finnish)
* Français (French (France))
* Deutsch (German)
* Ελληνικά (Greek)
* עִבְרִית (Hebrew)
* Magyar (Hungarian)
* 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 (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).