Coder Social home page Coder Social logo

hyunsupul / aesop-core Goto Github PK

View Code? Open in Web Editor NEW
245.0 25.0 59.0 8.02 MB

Open-sourced suite of components that empower interactive storytelling in WordPress.

Home Page: http://aesopstoryengine.com

License: GNU General Public License v2.0

JavaScript 59.25% CSS 4.61% PHP 28.11% Less 8.04%

aesop-core's Introduction

Aesop Story Engine
A collection of thirteen unique storytelling components wrapped in a plugin.
Scrutinizer Code Quality License i18n

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.


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

See http://aesopstoryengine.com/developers.

Bugs

If you find an issue, please let us know here!

Support

This is a developer's portal for Aesop Story Engine and should not be used for support. Please visit our support forums if you have a question.

Contributions

Contributions are more than welcome. Please read our current guidelines for contributing 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
  • Image
  • Location
  • Parallax
  • Quote
  • Timeline
  • Collection
  • Document

Interactive elements are created while crafting stories, with the Story Component Creator. Image

Changelog

See releases for more.

Translations

Aesop Story Engine is currently available in 36 languages. We work closely with the folks over at WP-Translations, and it's because of them that these translations are available. You're welcome to jump in.

  • العربية (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 (Chile))
  • 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.

aesop-core's People

Contributors

aaemnnosttv avatar alchemyunited avatar alexxgermann avatar andywilkerson avatar artjomsimon avatar cherbst avatar crowjonah avatar dependabot[bot] avatar etcook avatar ethanclevenger91 avatar fxbenard avatar harvitronix avatar hyunsupul avatar mauryaratan avatar michaelbeil avatar peiche avatar scrutinizer-auto-fixer avatar sebasoft avatar simplemama avatar smeric avatar tmeister avatar trzyem avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

aesop-core's Issues

How to begin using your plugin

I have loaded and activated your plugin on my new website, storiesfromacottage.com. I cannot figure out how to use it on my website. Is it because my plugin says it's beta version 0.9.5?
I signed up to receive an invite code, but I haven't received one. Is that how I will be able to begin using your plugin on my site until version 1 is released? I want to tell my readers about aesop story engine, but I can't until I can figure out how to use it.
Would be best to wait until version 1 is released this month?
I will sign up to get notified of the release of version 1.0.

Aiming to look as Aesop Story site

Hello, I have installed the plugin on my site and still learning it.
http://bisaya.asknoypi.com/

But my problem is I don't know how to look as Aesop website looks like or just have an idea on it. Like for example each story can be scrollable and its on full view. But on my website it is situated on the blog post. What kind of wordpress template should I use? Just like this: http://playground.aesopstories.com/

Thank you and hoping for your consideration.

Yours truly,

-lordzden

Issue with maps

No matter what coordinates I add the the post the map is always the map of London.

Plugin causes new pages to load at middle or bottom of page

This plugin was causing new page loads of pages that have nothing to do with the plugin to load half way down the page or almost at the end, depending on how long the page was. The beta version is 0.9.97. I'm not sure if the issue is fixed in 0.9.99.

Stories missing in wp left panel

Hi, I just installed your plugin but i can't fing "Stories" in the left panel. The only changes I get is "Gallery" in left panel and add component for articles, pages and galeries.

Did I miss something? I'm using wp 3.8.1 in french. I tried on WPMU installation / TwentyFourteen activated and standard wp 3.8.

Could you help please ?

Thanks.

best regards

Jérôme

HiDPI Icons

Great plugin! But seeing those blurry images isn’t really cool 😞

Since Aesop is compatible with 3.8+, it could really make use of Dashicons for icons such as Image, Audio, Video, and for the rest it can have it’s own web font.

Thoughts?

Request for Easier Theme Support

I'm working on integrating this plugin into my new full-width theme and wanted to discuss this with you to possibly simplify theme integration even further.

From your documentation it says to add a do_action( ' aesop_inside_body_top' ) right after the body tag and before the header. In all the WordPress Core themes, TwentyXYZ, there is already a do_action very close to there. Specifically:

>
<?php do_action( 'before' ); ?>

Its inside the page div, but typically that page div is used to include the entire page. If that will work you could just hook into that existing action.

Then it says to add the aesop_entry_content CSS class to the main content div. That is always called "content" in these core WordPress themes. Like this:

<div id="content" class="site-content">

So your style sheet could just apply the aesop_entry_content styles to #content or .site-content.

I'm not exactly sure where to put the .aesop-entry-header where the scroll to nav goes. It could probably be tied into the top of the #page div, though. At least by default.

Last but not least is the part about containing the story content within the typical width of the theme's page or post. The core WordPress themes all use a global variable called $content_width. Its pretty much a standard for telling the server (PHP side) the maximum page width (while of course the real page width is controlled by CSS).

So you could include an inline style that used that width like this:
.aesop-content {
width:100%;
max-width:
margin:0 auto;
}

This variable can be easily overriden in a child theme or users could just do it in the CSS directly by changing the width of .aesop-content.

So if this all works, I think you can get 100% compatibility with any theme based on _S without the theme developers doing anything. I believe that would go far in increasing the popularity of the plugin, especially on WordPress.com where it costs money to alter the CSS and they can't edit the PHP files at all.

Replace Metabox UI

We need to replace the metabox UI class with something hand-written as it's not sustainable to keep this included long term.

Reference
#2

  • preserve keys to maintain backwards compatibility
  • fields need to be repeatable
  • keep old metabox library until 2.0, and load for older versions

Rewrite Component Generator

The current rendition of the generator is great, but needs to be rewritten to include the ability to edit components. Having to manually edit them, or recreate them is a pain in the nuts.

Ideal user flow

  1. User clicks "add component" button like current
  2. Modal pops up, presents them with components area
  3. User operates largely as they do now
  4. Components then appear as a graphic, with edit icon
  5. User clicks edit icon and is shown only that components attributes to edit and save

Todo

  • create mockup of new generator

Must have

  • media library integration
  • colorpicker (keep old or go with new iris?)
  • filterable tabbed area for 3rd party plugins to hook into
  • components modal area must be filterable

Audio does not work

I tried to place audio in the posts but nothing shows up in the post. I deactivated all plugins except Aesop but nothing changed.I placed this shortcode there:

[aesop_audio src="https://ia600306.us.archive.org/9/items/ISGM_Podcast-The_Concert-22/theconcert22_64kb.mp3"]

Wordpress Plugin - Installation Causes Post/Page Editing to Become Inoperative

Hi. Kudos on what looks like a really beautiful and enticing product in the Aesop Story Engine. I installed the Wordpress plugin today, and thought you would want to know it makes my post and page editing inoperative. When I click on "Edit Post," it gives me a white screen. I can go back to the dashboard just fine with my browser's "back button." It didn't seem to mess with my existing pages on the front end. I thought at first it might be a conflict with another plugin, but I tried deactivating all my other plugins on the site and ran it with only the Aesop Story Engine plugin activated, and got the same issue. I'm wondering if it's because I use a Genesis child theme (Dynamik).

Scroll Sound

Tie into existing audio component with a feature that hides the audio player but plays a sound when you scroll to that point in the story.

Image Optimization

Create a utilize standard set of custom image sizes. Nothing is optimized at the moment, image wise.

Kindle Silk Browser errors

The Kindle Silk browser returns a < browserclasses.php > fatal error in < aesop-story-engine > on line 63.

Documents (images) do not show up

I can see the document in the post when it is a PDF, but the preview image for the JPG file I place in the post is just an empty grey rectangle.

Call to undefined function has_shortcode()

When ever I go to a post site (via permalink) i get the following error:

Fatal error: Call to undefined function has_shortcode() in /wordpress/wp-content/plugins/aesop-story-engine/public/includes/components/component-heading.php on line 91

Map not outputting

I've got the plugin working and outputting a number of components on a page.

However, the map component isn't displaying a map. It outputs some markup but nothing to see.

I've set coordinates in the meta panel and included the map component with a height set. Is there anything else I need to do or include in my theme to get this to display?

Aesop Hosted - Aesop Theme - Toggle Header

need some way for user to upload a logo and stuff, maybe toggle header, drops down to reveal author avatar, maybe a small list of their most popular stories, and ability to follow them? subscribe? twitter links?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.