Path

ez projects / ezjscore


eZ JSCore

UNIX name Owner Status Version Compatible with
ezjscore André R. stable 1.0 4.x
An ajax extension for easier client / server integrations using yui 3.0 and/or jQuery.
It also includes tools for on demand script / css loading and json / xml encoding
content. Its included in eZ Publish 4.2 when you install webin or flow, aims to support all 4.X versions and is going to be fully bundled in 4.3 (like ezoe).

* "StarRating" implemented on top of ezjscore: http://projects.ez.no/ezstarrating

Requirements

  • eZ Publish 4.0 and higher
  • PHP 5.2.1 and higher OR
  • PHP 5.1.2 and higher + PHP JSON extension

Examples

Example of use with yui 3.0:
{ezscript_require(array( 'ezjsc::yui3', 'ezjsc::yui3io') )} 
<script type="text/javascript">
{literal}
YUI( YUI3_config ).use('io-ez', function( Y )
{
    Y.io.ez( 'ezjsc::time', {data: 'postData=hi!', on: {success: function(id,r){ alert(r.responseJSON.content) }}} );
});
{/literal}
</script>
 
Example of use with jquery:
{ezscript_require(array( 'ezjsc::jquery', 'ezjsc::jqueryio') )} 
<script type="text/javascript">
{literal}
    jQuery.ez( 'ezjsc::time', {postData: 'hi!'}, function(data){ alert(data.content) } );
{/literal}
</script>
 
Full examples from existing implementations:

History

This extension is the continuation of ezyui (which was the continuation of ezcore)
with added support for jQuery in additions to yui 3.0 by popular demand. It's also been cleaned up and keyword and rating code has been removed/moved to other projects as this extension is meant to only be the building block that other extensions can build upon.

About

* jQuery, YUI 2.x and YUI 3.0 is bundled (but CDN used by default)
* On demand JavaScript / css loading
* Packing and minification of loaded files
* Files are served by Apache/web server so only overhead on generation witch is cached and can be placed inside cache blocks that are pr uri
* Supports php and template handlers to generate JavaScript and css dynamically (same one used to integrate eZ Publish i18n with tinymce in ezoe)
* including php handlers to automatically get jQuery/Yui[2|3] from either cdn or locally based on settings in ezjscore.ini (see examples on project page)
* These handlers can also be called directly from JavaScript as a an very simple to setup Ajax call, as done in example on project site.
* Above handlers have full permission support as defined in ezjscore.ini
* Ajax call's can be accelerated out of the box by using index_ajax.php

TODO

(and would be great to get some help / hints / requirements on)
* Documentation on how to get started. Currently there is only example on project page and in ezjscore.ini, as well as advance example in ezstarrating* and almost as advance example in ezoe 5.1.0alpha1**.
* Possibility to clear js/css cache from admin interface (currently you'll have to clear var/<site>/cache/public/*)
* template handlers does not let you specify expiry time like static files (modified time) and php handlers do ( ::getCacheTime )
* Instructions on how to setup "[ezscript|ezcss]_load()" on plain setup as well as ezwebin versions lower then 1.4 (aka ezflow lower then 1.1)***
* Possibility to specify version you want of jQuery/YUI, currently you'll get what the ezjscore is configured for, should maybe be possible to select major branches like YUI 2.7 vs 2.8, but this is non issue in YUI 3.0 as it handles version loading in JavaScript..

* http://svn.projects.ez.no/ezstarr...content/datatype/view/ezsrrating.tpl

** http://svn.projects.ez.no/ezoe/tr...ent/datatype/edit/ezxmltext_ezoe.tpl

*** preview: http://ez.no/developer/forum/setup_design/ezstarrating_wint_plain_site_type_in_ez_4_2

No news yet.

This project has no reviews yet. Be the first one to review it!