eZpedia : eZ

Adding Path information

Thu, 08 May 2014 11:09:47 GMT

The $Result['path'] should be created like this to work proper with the treemenu operator:

$Result['node_id'] = 4711;
$Result['path'] = array(
    array( 'url' => '/content/view/full/2', 'node_id' => 2, 'text' => 'Home', url_alias => '' ),
    array( 'url' => '/content/view/full/100', 'node_id' => 100, 'text' => 'Something100', url_alias => '/something100' ),
    array( 'url' => '/content/view/full/200', 'node_id' => 200, 'text' => 'Something200', url_alias => '/something100/something200' ),
    array( 'url' => false, 'node_id' => 4711, 'text' => 'Something 4711', url_alias => false )
);</pre>

Twitter

Thu, 16 Jan 2014 10:28:55 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

You can learn much by listening and following the eZ Community sharing on Twitter!

eZ Publish Twitter Content

Search Twitter for eZ Publish related tweets!

eZ Publish Community related Twitter accounts

The feeds available breakdown to the following primary Twitter accounts :

@ezcommits	eZ Publish & extensions (eZ's, hosted on github) commits,
@ezpublishevents	eZ Community-related events, proposed on the brand new Event Planner
@ezpublish_jobs	Job offers coming-out of the soon-to-come Job Board (Review the in-progress RFC here),
@ezcommunity	Notifying the social sphere of new forum topics, new blog posts, new tutorials, and also used by yours truly for manual message.

On top of the above more social channels, you also still have the more traditional, yet very useful eZ Community RSS feeds.

References

Startseite

Thu, 09 May 2013 00:21:54 GMT

Subjects

Read and update documentation on any eZ subject current or otherwise, created by the members of the community or from eZ Systems

Learn! Start learning and practicing developer, development and extension documentation which educates how add new or extend existing functionality within eZ Publish
Search! For solutions to questions previously solved and best practices
Study! The source code api documentation and api source code snippets
Report! Review and report unique issues using eZ Systems' issue management site for all their products (eZ Publish, eZ Components, eZ Newsletter, Online Editor, eZ Find)
Review! Changelogs
Read! The list of latest commits to the eZ Publish public subversion repository via RSS or StatSVN
Download! The latest eZ publish source code, extensions, source code and official releases

Tips

Read! Our faq of documented problems, experiences, references and solutions!
Search! Still searching for answers, experiences or references? Consider searching eZpedia, GooZee, ez.no, or your favorite search engine via helpful browser search plugins with related keywords.
Write! Still can't find a clear answer? Ask your questions in clear, detailed, unique way via the irc and then in forum.
Clear! Try clearing all the cache!
Support! Support eZ community projects!

Willkommen in eZpedia!

Checkout the latest reported news on anything eZ Publish via eZpedia (Recently, Email, Rss, Feeds, Updated, Discussion, New), eZ Share (Forums, Blogs, Articles, Download, Events, Directory, Get Involved with eZ Publish!, eZ Publish Project Roadmap), eZ Ecosystem, eZ Projects (WebSVN, ViewVC), PubSVN, GitHub, eZ Systems' Issue Tracker (eZ Publish, Community), eZ Ecosystem (Community Planet), eZ Publish Planet, Apache Zeta Components, eZ Systems, Digg, Reddit, StackOverflow (Recent, Tags), Snipplr, Meetups, LinkedIn, FriendFeed or Twitter, eZ Publish Love * or Hate * on Amplicate!

Namespaces: Updated, New | eZ, Solution, Learning, Project, People, About, Template, Help, Snippet (eZp3), Spotlight, Historical, Minutes

If your looking for a general overview of eZpedia review the contents of each namespace.

There are a number of community efforts to collaborate with the entire eZ community.

Many of these projects are to provide vital tools, resources and documentation to the community. See a need, fill a need ...

Projects

Become fluent in eZ, Learn when to contribute and support the community

Community - Dedicated Site Discussion (File, PDF)
Projects - Projects
eZpedia - Documentation
PubSVN - Latest - builds, statistics and subversion services
eZ Open Funding: The Defeat of Dysfunctional Development

Extended attribute filter

Tue, 26 Jun 2012 11:23:15 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

The content/tree_count and content/list_count fetch functions

This feature is available since eZ publish 3.9.

Since eZ publish 3.9 extended attribute filters can also be used in the content/tree_count and content/list_count fetch functions.

Example

There are many example uses of possible uses of extended attribute filters.

Here is one example from the forum, It's possible to have 'and' and 'or' in attribute_filter

Extensions containing extended attribute filters

You will find more of them in this list on projects.ez.no.

Troubleshooting

If eZ Publish doesn't seem to want to load your extended attribute filter, then you might want to check out some useful tips to get it to work at the Troubleshooting extensions page.

External resources

Template Operators

Thu, 29 Mar 2012 09:55:13 GMT

About

Template operators plug into the Template system in eZ publish and are programmed in PHP. Template Operators can take input, transform it, and return a result to the template. eZ publish comes with a lot of built in template operators.

Alternatives

If you looking to save yourself a lot of development time and your not using a certified platform (re: eZ Publish Now) we suggest you use the wrap operator

Inside Template Operators

How template operator usage

Typical usage of a template operator is like this:

{'input'|mytploperator('param1','param2')}

How template operators work

Template operators provide a template language function for your existing php function.

When to create a template operator?

If you have a lot of loops, ifs and fetches to manipulate variables, that is usually a good idea to put in an template operator.

What can you do

It is typically useful for:

Manipulating variables ( arrays, strings, numbers, etc )
Extracting information from eZ publish or external system
a combination of the above

Creating a template operator

In the administration interface of eZ publish there is a wizard that helps you creating template operators. Go to "Setup" - "RAD" - "Template Operator wizard"

Put more detailed example here..

When to use template operators? Why there are so few template operators or documentation on them as a category or subject?

How to enable a template operator

How to debug a template operator not loading error

Settings - If valid settings are not properly configured your template operator will not be loaded
Code - If you have a code problem with your template operator.

Debug Tip

Ensure that the autoloads directory for your template operator is properly configured in the settings

From file, ' extension/ezgpg/settings/site.ini.append'

#?ini charset="iso-8859-1"?
# eZ publish configuration file.
 
[TemplateSettings]
AutoloadPathList[]=extension/ezgpg/autoloads

Insert an echo statement in your templatate operators autoload php file. From file, 'extension/ezgpg/autoloads/eztemplateautoload.php'

<?php
 
eZDebug::writeWarning( 'eZGPGOperators::autoload : load template operator' );
 
echo("eZGPGOperators::autoload : load template operator || is loaded ...<hr /><hr />");
// Operator autoloading
 
$eZTemplateOperatorArray = array();
$eZTemplateOperatorArray[] = array( 'script' => 'extension/ezgpg/autoloads/ezgpg_operators.php',
                                    'class' => 'eZGPGOperators',
                                    'operator_names' => array( 'ezgpg_decode' ) );
 
?>

When to use a template operator

When you need to provide a feature via function in templates.

Why to use a template operator

It is the only way to access additional user defined features without kernel or extension modification

Using PHP functions as template variables

strip html tags

To remove html tags from a string.
=============================
In template.ini(.append.php)
add under
[PHP]
....
PHPOperatorList[striptags]=strip_tags
......
Then in your template use
$yourstring_with_xml|striptags
and catch the stripped output
=============================
See: https://ez.no/community/forum/developer/operator_to_strip_off_html_tags

Creating your own template variables in a simpler way

Use the OWSimpleOperator or Wrap Operator extension to create your own template operators or use all available php functions.

Listing all available template operators using ggsysinfo extension

Use the ggsysinfo extension which provides a module view to list all available operators and which extension they might belong.

This view is amazing because you can quickly determine which template operators might be used within a giving eZ Publish installation.

Troubleshooting

If eZ Publish doesn't seem to want to load your template operator, then you might want to check out some useful tips to get it to work at the Troubleshooting extensions page.

Extension information

Tue, 20 Mar 2012 20:25:13 GMT

This feature is available since eZ publish 3.9.

The ezinfo/about module view is used to convey related legal information like copyright, license, contributors, extensions, third party software, etc, and is enabled by default.

Information about extensions can be added to this view by creating an ezinfo.php file in the extension's root directory.

ezinfo.php standard

file path: myextension/ezinfo.php
PHP class name: myextensionInfo

(the bold text represents the variable parts of the names, you should alter them for your extension)

Here's an example of the info of the ezodf extension, placed in the file extension/ezodf/ezinfo.php:

<?php
class ezodfInfo
{
    function info()
    {
        return array(
            'Name' => "eZ OpenOffice.org extension",
            'Version' => "2.0.0",
            'Copyright' => "Copyright (C) 1999-2006 eZ systems AS",
            'License' => "GNU General Public License v2.0",
            'Includes the following third-party software' => array( 'Name' => 'PhpConcept Library - Zip Module',
                                                                    'Version' => '2.4',
                                                                    'License' => 'GNU/LGPL - Vincent Blavet - November 2004',
                                                                    'For more information' => '<a href=https://www.phpconcept.net>https://www.phpconcept.net</a>' )
     );
    }
}
?>

Note that the info method is static. For PHP5 compatibility, you will have to define it as follows:

static function info()

ezinfo XML Alternative - extension.xml

You can at your option use the extension.xml file within your extension instead of the php ezinfo standard.

Here is an example of an extension.xml file

<?xml version="1.0" encoding="utf-8" ?>
<software>
<metadata>
<name>BC Image Alias</name>
<version>//autogentag//</version>
<copyright>Copyright (C) 1999 - 2012 &lt;a href='https://brookinsconsulting.com'&gt;Brookins Consulting&lt;/a&gt; and eZ Systems AS</copyright>
<license>GNU General Public License</license>
<info_url>https://projects.ez.no/bcimagealias</info_url>
<source_url>https://github.com/brookinsconsulting/bcimagealias</source_url>
</metadata>
<dependencies>
</dependencies>
</software>

Disabling access to ezinfo/about

You can disable access to this module / view in the site.ini settings file - see eZ Publish Security for more information.

External resources

Issue: Spec for ezinfo/about

ezlupdate

Tue, 13 Mar 2012 22:19:25 GMT

About

eZ publish empty translation creation. ezlupdate is the general way to create .ts ( located in share/translations or extension/ezexample/translations ) files for the system (eZ publish)

Installation

Please read the README installation instructions.

Before building the program

The linguist is not provided with eZ publish 3, as this is distributed in the Qt library available from Trolltech.

The following assumes that you are building under unix. If you have a commercial licence of Qt for Windows and/or Mac OS X, you can build it in a similar way. If you don't have such a licence, you can get binaries from eZ systems.

First, make sure that you have the Qt library installed. If you use a package system such as RPM, make sure that you also have the qt-devel package. You need version 4.0 of the Qt library.

If you build ezlupdate against the Qt/X11 library, it will require X11 to run, even though it is a console program. If you have installed eZ publish on a server without X11 it is recommended that you build ezlupdate against Qt/embedded.

Dependencies

eZ publish 3 requires two programs to create and maintain translations, 'ezlupdate' and 'linguist'.

These programs are based on the same tools from the Qt toolkit by Trolltech (www.trolltech.com). The unix version of this toolkit is released under the GPL. eZ systems will provide binaries for Windows and Mac OS X.

The linguist is unmodified from the Qt original, so you also can get this from other sources, such as RPMs. ezlupdate is modified to make it understand eZ publish files.

Installing QT Linguist

...

Installing on Apple OSX Lion using Homebrew

Since Apple has broken compatibility with PowerPC compiled programs on Lion, you will not be able to use the binary provided for previous OS X versions : https://auth.ez.no/download/translations/ezlupdate_and_linguist

You can now very simply build (from sources) and install the ezlupdate program using Homebrew on Apple OSX computers.

Just install Homebrew and type `brew install ezlupdate` in your favorite terminal.

Notes :

The installer will download qt as a dependency
ezlupdate binary will be placed into /usr/local/bin/ by default (which should be in your PATH)
The Formula uses sources from eZ Publish Community 2011.10
This has been tested on Mac OS X Lion 10.7.2 so far (please report feedback on your OS X version)
Related blog post about this wonderful accomplishment in greater detail

Installing on Apple OSX Lion using macports

If you don't have qt4-mac, install it with macports

Then, go inside support/ezlupdate-qt4.5/ezlupdate and run

qmake ezlupdate.pro
make

The binary will be compiled and placed into bin/macosx/ so you might want to copy it in a location that is in your PATH environment variable.

Interesting and related blog post : https://share.ez.no/blogs/jerome-vieilledent/getting-ezlupdate-for-macosx

Installing using debs

...

Installing using rpms

...

Installing using source

...

External reference

memcache

Sun, 22 Jan 2012 22:32:37 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

Several different people have documented the use of eZ Publish with memcache / memcached with great success at improving eZ Publish performance

External reference

Forum: (Example Solution Howto) eZ session using memcached....Performance

Forum: xxx
Forum: Memcache / Suggestions / Forum
Doc: lighttpd

Versions

Fri, 20 Jan 2012 10:07:08 GMT

About

There are many versions of eZ Publish each is rarely the same as the last so pay close attention to what consists of each version, each community build and each release.

Version Chart

Here is an interesting version chart to read and learn more about the history / version(s) of eZ Publish and eZ Publish 4.x.

Releases Chart

Here is an interesting release history version chart

Features

Feature documentation is available by version from the eZ Publish GitHub repository.

Backwards Compatibility

Backwards compatibility documentation is available by version from the eZ Publish GitHub repository.

Changelogs

Changelog documentation is available by version from the eZ Publish GitHub repository.

Specifications

Specification documentation is available by version from the eZ Publish GitHub repository.

References

PubSVN: Version Chart for eZ Publish 4.x
Doc: Release version chart
Doc: Feature documentation
Doc: Backwards compatibility documentation
Doc: Changelog documentation
Doc: Specification documentation

Custom Fetch

Mon, 16 Jan 2012 11:52:29 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

Brief

The purpose of a custom fetch is to have an organized way to retrive data from a given data source. You mainly call a custom fetch function from templates.

The eZ Publish framework already provide a lot of different fetch functions out-of-the-box using the information extraction system.

You can also create your own custom fetch functions from within your own custom module extension.

Example

The following example is based on the example given by Bruce Morrison on the ez.no forums.

File: extension/ourcustom/modules/ourcustom/function_definition.php

<?php
 
$FunctionList = array();
$FunctionList['CustomFetch'] = array( 'name' => 'customfetch',
                                                  'operation_types' => array( 'read' ),
                                                  'call_method' => array( 'include_file' => 'extension/ourcustom/modules/ourcustom/ourcustomfunctioncollection.php',
                                                  'class' => 'OurCustomFunctionCollection',
                                                  'method' => 'fetchCustomFetch' ),
                                                  'parameter_type' => 'standard',
                                                  'parameters' => array(
                                                    array( 'name'     => 'the',
                                                               'type'     => 'integer',
                                                                'required' => true,
                                                                'default'  => 1
                                                      ),
                                                      array( 'name'     => 'params',
                                                                 'type'     => 'string',
                                                                 'required' => true,
                                                                 'default'  => ''
                                                              )
                                                      );
?>

Please note that the values associated with the keys 'name', 'operation_types' and 'parameter_type' are not used anywhere by eZ Publish itself.

Since eZ Publish 4, the 'include_file' key of the 'call_method' array is deprecated and won't be used anymore. Instead, the module system relies on the PHP 5 autoload feature.

File: extension/ourcustom/modules/ourcustom/ourcustomfunctioncollection.php

<?php
 
class OurCustomFunctionCollection
{
 function OurCustomFunctionCollection()
 {
 }
 function &fetchCustomFetch( $some, $params )
 {
   $result =& retrieve data here
   return array( 'result' => $result );
 }
}
 
?>

File: extension/ourcustom/settings/module.ini.append.php

<?php /* #?ini charset="utf-8"?
 
[ModuleSettings]
ExtensionRepositories[]=ourcustom
ModuleList[]=ourcustom
 
 
*/ ?>

Usage

This page of documentation clearly explains how to call and use fetch functions (custom or default) using the information extraction system.

{def $collection=fetch( ourcustom, customfetch, hash( the, params ) )}

References

Doc: Fetch
Forum: Custom fetch functions
Forum: How to do a fetch with PHP
Contribution: An example custom fetch module extension, bccontentdiffnotifications

fetch

Mon, 16 Jan 2012 11:50:09 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

Missing Description

Using Fetches

This page of documentation clearly explains how to call and use fetch functions (custom or default) using the information extraction system.

Custom Fetch

You can create your own custom fetch functions which you can use with a custom template operator or module.

External References

Blog

Mon, 16 Jan 2012 11:34:18 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

Extensions related to blogging

Blogs about eZ Publish

Individuals feel free to add your blogs here to this list

Best English eZ Publish blog on the entire internet, https://serwatka.net/blog
Another fantastic English eZ Publish blog, https://www.mugo.ca/Blog
An amazing English eZ Publish blog, https://www.netgen.hr/eng/Blog/
A German eZ Publish blog portal, https://www.ez-publish-blog.de/
Another older inactive German blog portal, https://ezpublish.de/Blog
Older French blog, https://www.gandbox.fr/Blogs/(tag)/eZ%20Publish (English translation via Google Translate)
Older inactive: https://ez.ryba.eu/

Planets about eZ Publish

Planets are blog rss feed content syndication distribution focal points on specific subjects.

The following are planets containing eZ Publish related blogs and blog posts.

https://share.ez.no/blogs
https://planetezpublish.org/
https://www.planet-ezpublish.fr/ (English translation via Google Translate)
eZ Ecosystem OPML
eZ Publish related blogs indexed on technorati.com

Persistent template variables

Sun, 15 Jan 2012 20:53:43 GMT

About

You usually require a persistent_variable when you need to pass a value from a (module result) template context into the pagelayout template context (outside of module result context).

Checking to ensure your persistent variable name is not already in use

Remember that another extension may already use the variable name you wish to use, so it may be important to search your templates to ensure the variable name is not already used previously as this helps ensure you do not overwrite existing variables.

Background

It can take a user of eZ Publish quite some time of learning before finding out how to use the persistent_variable template variables.

This article should help even the average user quickly understand how to work with the persistent_variable within the contexts of templates and even within the context of PHP!

This documentation was inspired by another user who shared in the forum thread, "Persistent variable unveiled"

Use case

You need to pass a variable from a module result template context into a pagelayout template context.

Examples

Modifying a variable in a module result template context (TPL)

When the 'persistent_variable' is of variable type 'hash' it is simple to modify it's contents within a module result template context using the set template function and the merge operator.

{set scope=global $persistent_variable=$#persistent_variable|merge( hash( 'key', 'value' ) )}

The above template code merges into the hash a new key/value pair.

Remember it is very important to use the set parameter 'scope=global' and '$#' to access the existing value within the in global template variable scope.

Also note the quotes around the examples are not actually part of the examples in the last sentence containing 'scope=global' and '$#'.

Accessing a variable in a pagelayout template context (TPL)

Now that you are modifying the persistent variable and adding a new key/value pair you can try to use this information within the pagelayout context (cache issues aside *)

{$module_result.content_info.persistent_variable.key}

Accessing a variable in a template operator context (PHP)

If you are creating an eZ Publish template operator in PHP code you can also access and modify this persistent variable within a module result template context.

$persistent_variable = array();
 
if( $tpl->hasVariable( 'persistent_variable' ) )
{
    $persistent_variable = $tpl->variable( 'persistent_variable' );
    $persistent_variable[ 'key' ] = 'value';
    $tpl->setVariable( 'persistent_variable', $persistent_variable );
}

Accessing a variable in a pagelayout template context from module result template context (TPL)

Now that you are modifying the persistent variable and adding a new key/value pair you can try to use this information within the pagelayout context

$module_result = $tpl->variable( 'module_result' );
 
$persistent_variable = array();
 
if( isset( $module_result['content_info']['persistent_variable'] ) )
{
    $persistent_variable = $module_result['content_info']['persistent_variable'];
}

Closing

If you wish to learn more please read this excellent blog on the subject, "eZ-Publish CMS persistent variables"

References

Blog: eZ-Publish CMS persistent variables
Doc: Template function set
Doc: Snippet: Template Variable Scope / Passing Variables to Template
Forum: Persistent variable unveiled

Git

Sat, 14 Jan 2012 03:29:15 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

Git for eZ Publish

History of Git

Wikipedia on Git!

Sharing eZ Publish related source snippets and examples using GitHub Gists

It's a recommended best practice to stop using traditional pastebin web site services to share source code files and snippets as this delivers overall poor features long term. Instead it is strongly recommended to use GitHub Gists to share almost any text based content via a web browser in seconds, it makes sharing source code examples more simple and more useful to the other party recieving and using these shared source code examples.

https://gist.github.com/

Git usage with eZ Publish

Use of Subversion for your eZ Publish projects is now deprecated.

The business and community projects for eZ Publish are all (slowly) migrating to using Git for version control.

We strongly recommend you replacing your Subversion usage with Git today.

eZ Systems now distributes the eZ Publish source code with Git repositories hosted on GitHub.com

eZ Systems also now distributes most of the currently supported eZ Publish Extension(s) source code with Git repositories hosted on GitHub.com

The eZ Community and eZ Ecosystem world wide is progressively migrating their own use of version control in their own development projects to Git (and many also to GitHub). projects.ez.no has been modified to support projects which use GitHub to host their project extension source code.

eZ Systems Extensions for eZ Publish

The currently supported extensions from eZ Systems are almost all hosted now on GitHub directly at

https://github.com/ezsystems

eZ Community Extensions for eZ Publish (on GitHub)

Organizations

Individuals

The following are just a few pioneering eZ Publish developers which distribute their extensions with Git on GitHub

Here is a dynamic google search for eZ Publish Developers on GitHub (who mention eZ Publish via Google)

Git Documentation

Official: Git Documentation
Reference: Git Reference
Cheatsheets: Git cheat sheets
Article & Screencast: Introduction To Git
Article: An Illustrated Guide to Git on Windows

Documentation on usage of Git with eZ Publish

Article: How to use your github.com repository on the eZ Publish extension forge : projects.ez.no
Article: How to contribute to eZ Publish using Git
Article: Translating & Localizing eZ Publish using GIT

Forum: Participate on the Tracker, through GIT, how?
Forum: Git life-cycle, development to production
Forum: Git stable-4.4 branch update
Forum: Updating from 4.3.0 to 4.3.1 (from git), some glitches
Forum: Managing a project with git
Forum: Switch to GIT? (Pre migration to Git by eZ Systems)

References

Article: How to contribute to eZ Publish using Git
Article: Translating & Localizing eZ Publish using GIT

Older community efforts to support Git usage with eZ Publish

These references come from before eZ Systems officially began to use, support and migrate most of their currently supported software to git for version control and GitHub for hosting, distribution and collaboration.

Doc: gitforez.pdf
Forum: Switch to Git
Blog: Community GIT repository for eZ Publish
Alternate hosting of Git Repo by YMC : https://git.forge.ymc.ch/

The eZ Song

Sat, 14 Jan 2012 03:24:12 GMT

About

The eZ Song is a song shared and sung within the community of eZ Publish a PHP/CMS/CMF.

The original song title is "The Sharing Song" and the original song author is Jack Johnson

Alternate names the song is also known

The eZ Song
The eZ Publish Song
The eZ Sharing Song
The eZ Publish Sharing Song
Sharing Song
The Sharing Song
Jack Johnson - The Sharing Song
It's Always More Fun
It's Always More Fun to Share
It's Always More Fun to Share with Everyone

History

The song has been with us for a long time so far ...

It is shared among the ecosystem and community

The song is seemingly not advertised per-say or referenced so much on the internet itself.

When it is mentioned it is often in passing and in text form alone.

Any search engine will surely bring these references to your attention and understanding should your seek them out after learning of this wonderful song and hearing it for the first time.

Trends

The song is often sung in groups
The song has a special meaning for us all
The song is an enjoyable reminder of our lives

Experiencing the song for yourself

Some have trouble finding a copy of the song to listen to so we did a few searches and wrote this article to help improve this situation for our friends in the community looking to learn more about The eZ Song and to hear it (perhaps for the first time privately).

Listening to the song

Some people really enjoy listening to the song (and we would not be surprised to learn of many people singing the song to themselves privately at the same time).

Random Youtube Mirror (2:45): https://www.youtube.com/watch?v=0hgiVfHIPxc
Random Youtube Mirror (Longer picture slideshow; 3:58): https://www.youtube.com/watch?v=bfSpsnLyo18
Uk Previously Shared Mirror: https://www.deezer.com/listen-2247842

Lyrics of the song

Some people enjoy reading the lyrics while they listen to the song.

Random Copy of Lyrics: https://www.azlyrics.com/lyrics/jackjohnson/thesharingsong.html
Random Copy of Lyrics: https://www.sing365.com/music/lyric.nsf/The-Sharing-Song-lyrics-Jack-Johnson/9057EF11C2140E9A48257115000DC36D

References

Wikipedia: Jack Johnson
Mention: https://www.visionwt.com/News/eZ-Conference-set-for-London
Mention: https://visionwt.podhoster.com/index.php?sid=2938&m=05&y=2011
Mention(s): https://share.ez.no/forums/discussions/ez-future-15-ez-publish-4.5-matterhorn-ahoy
Mention: https://twitter.com/#!/zurgutt/status/81458057095282688
Mention: https://www.meetup.com/eZ-Publish-Users-Developers/messages/boards/thread/19408082/#64253782

Subversion

Sun, 08 Jan 2012 05:19:30 GMT

About Subversion

Also known as svn or SVN.

History of Subversion

Wikipedia on Subversion!

Tips

Use of Subversion for your eZ Publish projects is now deprecated.

The business and community projects for eZ Publish are all (slowly) migrating to using Git for version control.

We strongly recommend you replacing your Subversion usage with Git today.

Site Development

Using Subversion to manage your eZ publish site development.

Reasons to use subversion to store the site specific customization

Simple to run several sites from a single eZ publish (stock) source directory.
Simple to mirror production or development installations using the production, settings,design,extension,bin customizations
Simple to sync changes from one environment / server / installation instance to others
Management of templates,settings,extension,bin,var file changes and releases
Archival of the entire history of your eZ publish development
Collaborative resource, share source code access with your developers, reduce development costs by using management processes

Dealing with changes made to var/ directory by eZ publish

It can often be time consuming to perform a manual commit to a site repository checkout with changes made to it by eZ publish. Especially adding or removing 1000+ files from the checkout. Here are some example commands which can be used to automate this process. After using these commands you may perform a hand commit or a mass (general/all files) commit.

Example Commands

Add new files in var/storage to svn checkout

# cd /web/pro/example.com/; find /home/web/pro/example.com/var/plain/storage/original/application -print0 | xargs -0 svn status | grep '?      ' | tr '? ' '\n' | xargs svn add

Remove files from svn which have been removed from var/storage by eZ publish

# cd /web/pro/example.com/; find /web/pro/example.com/var/plain/storage/ -print0 | xargs -0 svn status | grep '!      ' | tr '! ' '\n' | xargs svn remove

Log svn status command results to log file

# cd /web/pro/example.com/; svn status | tee ../example.com.status.2006.11.17.001.log

Unpack stock eZ publish and prepare build and create links

# cat /web/ini/bin/int.stock.svn.links.sh
#!/bin/bash
 
 
wget https://ez.no/content/download/152158/995731/file/ezpublish-3.8.6-gpl.tar.gz
 
tar -zxf ezpublish-3.8.6-gpl.tar.gz
 
ln -s ezpublish-3.8.6-gpl doc
 
cd doc
 
# move stock folders to invisible
 
mv bin .bin;
mv var .var;
mv design .design;
mv extension .extension;
mv settings/override settings/.override;
mv settings/siteaccess settings/.siteaccess;
 
# create links
 
ln -s ../example.com/bin bin;
ln -s ../example.com/var var;
ln -s ../example.com/design design;
ln -s ../example.com/extension extension;
ln -s ../example.com/settings/override settings/override;
ln -s ../example.com/settings/siteaccess settings/siteaccess;

Example eZ publish stock layout with symlinks to site repository checkout.

# ls -l
 
.ezpublish.3.8.6.stock
access.php
 bin -> ../example.com/bin
.bin.stock
clr -> bin/shell/clearcache.sh
cronjobs
design -> ../example.com/design
.design.stock
doc
extension -> ../example.com/extension
.extension.stock
ezpm.php
ezpublish.cron
index_image_mysql.php
index_image_pgsql.php
index_image.php
index.php
kernel
kickstart.ini-dist
lib
LICENSE
packages
pre_check.php
README.txt
runcronjobs.php
settings
share
soap.php
support
update
var -> ../example.com/var
.var.stock
 webdav.php
 
# ls -la settings
override -> ../../example.com/settings/override
.override.stock
siteaccess -> ../../example.com/settings/siteaccess
.siteacces.stock

Example site repository layout

# ls -l
      bin
      design
      extension
      favicon.ico -> favicons/example.white.star.ico
      favicons
      robots.txt
      settings
      tmp
      var

Note: This method has a few negative side affects long term maintenance. First storing the extension directory as a whole provides for stronger extension source code management.

Yet for general purpose usage this notion of storing the extension dir should be removed and replaced instead with an abstraction. Instead of storing extensions per site repository, store your extensions in a separate repository, install ezsvn and use it to install your extensions needed via external repository.

Second, the design directory should really only contain the non-stock site design directories. These would be symlinked into your existing stock design directory.

Third, the settings directory should really only contain the non-stock override and siteaccess directories. These would be symlinked into your existing stock design directory.

External Links

ezsvn project
svnmerge.py

This is a Stub article. Help the eZ Publish community by expanding it!

Creating file upload feedback forms using information collection system and the enhanced ezbinaryfile extension

Sun, 08 Jan 2012 04:33:45 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

Often users are looking for a way to create an information collection form (for feedback, resumes, etc) which allowed binary files like pdfs to be uploaded.

This features is specifically not supported by the default eZBinaryFile datatype provided with every copy of eZ Publish.

Example solution: Enhanced eZBinaryFile extension for eZ Publish

About: Enhanced eZBinaryFile extension

This datatype was developed to make it possible to send binary files collected from forms as multipart MIME emails. For example, the enhanced eZBinaryfile datatype can be used to allow people to attach documents to information collection forms / feedback forms.

Example solution: Enhanced eZBinaryFile extension for eZ Publish 4.x+

This extension is available for download on projects.ez.no/enhancedezbinaryfile

Please note that this specific project for the extension hosted on projects.ez.no is not compatible with eZ Publish 3.x instead it is only compatible with eZ Publish 4.x+ and PHP 5.x+. See the following section for the eZ Publish 3.x compatible solution available (older versions available).

Example solution: Enhanced eZBinaryFile extension for eZ Publish 3.x

This extension is available for download on pro jects.ez.no/enhanced_ezbinaryfile

Note: This specific project for the extension hosted on projects.ez.no is not compatible with eZ Publish 4.x+ instead it is only compatible with eZ Publish 3.x <= 3.10.x and PHP 4.x.

External Reference

Project: enhancedezbinaryfile (eZ Publish 4.x+ Compatible)
Project: enhanced_ezbinaryfile (eZ Publish 3.x Compatible)
Forum: How to use file uploads in a contact form?
Forum: How to use file uploads in a contact form? (Changes required to make this extension compatible with eZ Publish 4!)
Forum: Files and collected informations

IRC

Sat, 07 Jan 2012 14:57:16 GMT

For a general description of irc, we recommend IRC (Internet Relay Chat) on Wikipedia.

About

An unofficial eZ publish IRC channel exists on the freenode IRC Network, called ' #ezpublish'

I.R.C. stands for Internet Relay Chat.

Many of the active eZ publish community members and developers can be found in #ezpublish

IRC is a great resource for real time support, collaboration and communication.

Disclaimer

Visit #ezpublish on IRC (chat.freenode.net) ask a question and start a conversation with the active eZ publish irc community.
We urge users to be patient, detailed and persistent with their queries. Before leaving, ask the forum and in the meantime, try clearing the cache ;)

Rules

Please do not ask to ask a question
Please use the eZ publish pastebin
Please no spamming

Channels

The following alternate irc channels have been known to be in use or used

#ezpublish
#ezpublish-info
#ezcomponents
#ezpedia
#ezc
#ezpublish-fr
#ezpublish2

Chat in the #ezpublish channel on Freenode.net IRC via Web Browser

You can chat with other eZ Publish users from your web browser, simply login to the IRC service using the following link, remember to join the #ezpublish channel specifically. https://webchat.freenode.net/

IRC Topic Text

eZ publish | cms | Welcome to #ezpublish ... We urge users to be patient, detailed and persistent with their queries. Before leaving, ask the forum and in the meantime, try clearing the cache ;) || https://ez.no/community | https://ezpedia.org | https://pubsvn.ez.no | https://planetezpublish.org || News: https://ez.no/community/news/community_newsletter_17_11_2006 | Articles: https://ez.no/community/articles
eZpedia | wiki | The community documentation project for eZ Publish | https://ezpedia.org/
eZpedia | wiki | The community documentation project for eZ Publish | https://ezpedia.org/ | Search eZpedia.org through irc! https://ezpedia.org/wiki/en/ez/ez_community_irc_services#eztoc204760_2_2_1

References

Forum: LiveChat for developers and for debuging
Doc: Pastebin
Doc: eZ Community IRC Resources
Doc: IRC Bot

Books

Sat, 07 Jan 2012 14:21:31 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

Several books on the subject of eZ publish have been released over the years from several different publishing companies.

Distributors

You can obtain eZ Publish books from the following publishers / distributors (among others).

Packt Publishing
eZ Systems
Amazon (UK)
Other/Individual

Titles

The following are the most popular English books on the topic of eZ Publish.

eZ Publish 4: Enterprise Web Sites Step-by-Step

The sixth book, 'eZ Publish 4: Enterprise Web Sites Step-by-Step', released on [release-date], is an interesting handbook for web developers.

A pdf version of the book is available.

Managing eZ Publish Web Content Management Projects

The fifth book, 'Managing eZ Publish Web Content Management Projects', released on [release-date], is an interesting handbook for team lead / project manager / consultants.

A pdf version of the book is also available.

eZ Publish Advanced Content Management Book

The fourth book, 'eZ Publish Advanced Content Management', released on [release-date], is a very useful handbook for new administrators.

This book is a useful read for both new users, customers, administrators and experienced eZ developers.

A pdf version of the 'eZ Publish Advanced Content Management Book' book was also released.

Free Download of the PDF of this Book from ez.no

You can download this book from ez.no by filling out this form or direct download

Warning: A friends tell us that there's a bug in the above ez.no pdf book download form. The download is free of charge but requires you fill out the form with psudo information.

The downloads work perfectly except there is one bug. If you open eZ Publish Content Management Basics Book download form link, then go to the eZ publish Basics Book download form link (again), fill out the form with psudo information and submit the form you actually will download the eZ Publish Content Management Basics Book". So be careful to avoid this bug when downloading the free pdf books or alternatively use the direct download links.

eZ Publish Content Management Basics Book

The third book, 'eZ Publish Content Management Basics', released on [release-date], is a very useful handbook for new administrators.

This book is a useful read for both new users, customers, administrators and experienced eZ developers.

A pdf version of the 'eZ Publish Content Management Basics' book was also released.

Free Download of the PDF of this Book from ez.no

You can download this book from ez.no by filling out this form or direct download.

Warning: A friends tell us that there's a bug in the above ez.no pdf book download form. The download is free of charge but requires you fill out the form with psudo information.

The downloads work perfectly except there is one bug. If you open eZ Publish Content Management Basics Book download form link, then go to the eZ Publish Advanced Content Management Book download form link (again), fill out the form with psudo information and submit the form you actually will download the eZ Publish Content Management Basics Book". So be careful to avoid this bug when downloading the free pdf books or alternatively use the direct download links.

The eZ publish Basics Book

The second book, 'eZ publish Basics', released on [release-date], is a very useful handbook for new developers.

A pdf version of the 'eZ publish Basics' book was promised to and was released in December/2006.

This book is a useful read for strong eZ developers and new users.

Free Download of the PDF of this Book from ez.no

You can download this book from ez.no by filling out this form or direct download.

Warning: A friends tell us that there's a bug in the above ez.no pdf book download form. The download is free of charge but requires you fill out the form with psudo information.

The Learning eZ publish 3 Book

The first book, 'Learning eZ publish 3', released in 'May 2004'.

While containing useful information for advanced topics useful for strong users of eZ publish, it was not as useful to all new developers.

A pdf version of the 'Learning eZ publish 3' book is also available.

It has not yet been updated with a second edition.

Free Preview of the PDF of this Book from Google Books

There is a preview of (almost) the whole book available through Google Books.

View parameters

Wed, 04 Jan 2012 01:28:35 GMT

About

You can use view parameters to pass variables to a template.

View paramters are not normally cached.

View parameters availability

Remember view parameters are by default available only within the context of the content module and it's views.

All other modules (by default) do not support this feature.

The recommended alternative to view parameters in these situations would be using get / post parameters instead.

Cache block requirements when using GET/POST parameters instead of view parameters

Remember view parameters are not normally cached. This is very helpful to most developers.

If you do use get/post parameters instead of view parameters ... please, remember that the developer using get/post parameters -must- also add cache-blocks to the templates in question where the get/post parameters are used.

Cache blocks are required as the get/post parameters would be cached without the cache blocks and the values of the get/post parameters would not change (the values would be served from cache instead).

Parameters available within the layout/set module view

Since view parameters are available via the content module by default you should not try to use them within the context of the layout module or it's views like the popular layout/set view.

More specifically view parameters may not be available (or contain content) within the layout/set module view if view caching is enabled. One developer reported them existing without view cache but that they were not usable.

The recommended alternative to view parameters in these situations would be using get / post parameters instead.

Examples

/news/(sort)/name/(filter)/true/(search)/textString/

References

Solution: Converting HTML Form Post Variables into URL View Parameters
Solution: Adding userParameters to the user module in ezPublish
Doc: Module

External References

Forum: Passing parameters to the feedback form
Search: Forum Topic Search

eZ Publish 5.0

Mon, 02 Jan 2012 09:47:52 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

Preview

A preview release of eZ Publish 5.0 has been hinted to be in the works for March 2012

References

Forum: First public mention on share.ez.no, "2012 - It's going to be a great year!"

Package

Thu, 15 Dec 2011 04:41:02 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

For a general description of package, we recommend Software package on Wikipedia.

What is a package?

An eZ publish package is used to distribute certain parts of an eZ publish installation to other eZ publish sites. These parts include content classes, content objects, site styles and extensions. The setup wizard also uses packages, the so-called "site packages".

File format

An eZ publish package file can be recognized by it's filename extension .ezpkg. Package files do not have their own MIME type, they are served as the default type application/octet-stream.

Actually a package is a gzipped tar file. The PHP zlib extension is required because it is used to compress and decompress eZ publish packages.

The package file contains a file called package.xml. This file contains the package definition in an XML dialect.

Package management

You can create, install, or remove packages with the online package manager or with the command line package manager.

Compatibility

"Based on my experience, packages between version don't work smoothly. I'd suggest to copy the db and do an update by hand with the provided mysql/postgres sql files + run the php if needed." -- X+

Tip: Package distribution, selection, downloading and installation

Remember that prior to the eZ Publish 3.8 release, packages were distributed within the ezpublish download source packages (tar.gz, zip) themselves.

After eZ Publish 3.8 release, these packages were further distributed to the installations on demand during the setup wizard package selection, download and import.

Tip: Avoiding package download and import errors within setup wizard using eZ Publish 3.8.0+ (or greater version)

The following advise applies to eZ Publish 3.8.0 through 4.6 (Community Build 2011.11)

Have you ever have trouble during the setup wizard package selection, downloading and importing of the default eZ Publish packages like eZ Flow, eZ Webin or others?

This issue in question seems to be reported most frequently by users who's internet server (web server for example) which is behind a restrictive firewall or proxy server. In short when eZ Publish because of PHP configuration, curl availability, or restricted internet access for the server to use making outgoing requests ... can not connect to the remote package server.

If you do provide the web server with network access, php-curl or certain built-in PHP functions disabled, you must either solve the aforementioned problems or ... you must install packages using a local repository directory.

Did you know you can download these packages yourself from the Official eZ Systems' eZ Publish ezpkg package server, https://packages.ez.no/ezpublish/

Before using the setup wizard at all ... please perform the following steps with special attention to the specific details as they are key to solving this problem.

Simply navigate to /path/to/ezpublish root directory.
Download -all- the files (specifically index.xml and *.ezpkg file extension file name) in the package server's release directory (release version number) (IE: '/4.6/4.6.0/') which corresponds to the version number of the copy of eZ Publish you are trying to setup using your own preferred method, yourself, from the Official eZ Systems' eZ Publish ezpkg package server, https://packages.ez.no/ezpublish/
1. For example with eZ Community Build 2011.11 you will want to download all files (including the index.xml file) in found within the package server's release directory (release version number) (IE: '/4.6/4.6.0/') into 'var/storage/packages/eZ-systems/' from this remote url, https://packages.ez.no/ezpublish/4.6/4.6.0
2. Most users do not understand or realize the package names they require to complete setup normally which is why I recommend getting them all as you can repeat the process again more gracefully with all the packages and choose different setups as needed or desired.
3. If your an eZ Publish expert, know the package management systems related, and know the package names your require then you can choose to download only the packages you know you need.
4. No additional subdirectories are supported or allowed. If you use additional subdirectories (beyond the directory named the same as the package minus the extension '.ezpkg' with the contents of the package itself) your uncompressed packages will not be detected or imported from local sources.
5. Do not simply mirror the the package server or more than one of it's directories as this directory structure is not supported at all with local package installation. The local package import directory should contain almost the same files as the remote version specific directory.
6. Again, make certain the web server (user and group) can read and write to all the files in the package directory.
Extract all downloaded package files (*.ezpkg) -into- a new directory for each package (you must create this) with the same name as the package (without the '.ezpkg' file extension)
1. IE: the ezwebin_site.ezpkg file extraction directory I would need to create would be called ezwebin_site
2. Remember .ezpkg files are really just renamed tar.gz files in a very specific directory structure which must be maintained. You can use the gnu tar to extract the contents of the packages into directories with the same base name.
3. You can use this simple bash script to extract the packages correctly within the above directory as current directory on Unix-like systems with the Bash shell it's called bcuncompressezpackages.sh
  1. You can get a copy of this script from GitHub, https://github.com/brookinsconsulting/bcuncompressezpackages
  2. If you don't want to check out the script using Git. Here is a direct link to the raw script, simply copy and paste into a file in the root ezpublish directory with the filename of 'bcuncompressezpackages.sh', https://raw.github.com/brookinsconsulting/bcuncompressezpackages/master/bin/shell/bcuncompressezpackages.sh
  3. To run the script simply first set it's file permissions, chmod 777 ./bcuncompressezpackages.sh;
  4. Then feel free to run the script. You must run the script for the eZ Publish root directory or it will fail. cd /path/to/ezpublish; ./bcuncompressezpackages.sh;
  5. Then feel free to continue with the following setup setup steps.
4. If your concerned about file owner/group permissions you can optionally free yourself from any concerns in this regard by changing the package directories recursively file and group permissions to 777
5. You'll thank yourself later when you have no setup problems that you assigned these permissions to these packages' directories.
Re-start the setup wizard and complete the setup wizard normally. Local packages will be used to complete setup. It's painless and accurate.
1. Packages should be installed from local sources using the local package directory after each request for the remote package file from the setup wizard to the remote package server fails (unavoidable, not visible or apparent behavior).
Your done! Enjoy the time you saved, take a break, enjoy nature and a tall glass of orange juice!
1. You can optionally remove the downloaded / original package (.ezpkg) files out of the 'var/storage/packages/eZ-systems/' directory as they are no longer required or you can leave them as they cause no harm and only consume disk space.
Warning: While you can remove the actual compressed package files above as described we must be clear ... we -do not- recommend removing the uncompressed package directories or their contents as these files are expected to live here indefinitely as they represent part of the now installed packages in eZ Publish.

Did you know? Local package import/installation and setup wizard completion time is much faster than remote package import and installation during setup wizard!

Here is a related companion forum reference regarding this problem and this recently updated solution

Details about the setup wizard's behavior during package import and installation

It may also be worth mentioning here is the fact that even after failing to fetch the initial index.xml file from the remote package server, the setup wizard will continue to try to use the internet / remote package server regardless of the first (or continued) failure -or- the existence of local xml / remote packages in the correct directory at the correct time, etc. It always tries to use the package server first, then falls back to checking after each failure for a local copy (uncompressed) in the package dir mentioned above.

The setup wizard first it tries to use curl (if available/installed/detected/etc) to fetch the files from the remote package server and then falls back to try using to use built-in / core php functions and perform another attempt to connect using the different method. Now if either of those features also are not available (depending on your php configuration) you can get the same remote packages server connection errors as well.

The files which are fetched from the remote package server are first temporarily stored in 'var/cache/packages/' (using the same file name as found on the remote host) before being copied to 'var/storage/packages/eZ-systems/' directly. You may also wish to check the permissions of the 'var/cache/packages/' directory as if it is incorrect the remote package selection may fail.

These changes were introduced and released in eZ Publish 3.8. They were clearly documented in the provided feature documentation.

Tip: Avoiding package download and import errors within setup wizard using eZ Publish 3.x through 3.6.12

Have you ever have trouble during the setup wizard package selection and importing of the default eZ Publish packages?

You can replace the packages which are normally distributed with eZ Publish (3.x -> 3.6.12) release packages. This might help if you do not have these packages at this time and need to reinstall eZ Publish or simply re-run the setup wizard more specifically.

If you create the 'packages' directory in the root ezpublish directory and download the required packages into this directory before running the setup wizard you will install your packages via local sources.

In this way you may also be able to install custom packages here as well?

Simply navigate to /path/to/ezpublish root directory.
Create directory 'packages' in the root ezpublish directory.
Change directory file and group permissions to 777
You'll thank yourself later when you have no setup problems that you assigned these permissions to the 'packages' directory .
Download the packages you require / design into the 'packages' directory directly using your own preferred method yourself
Remember to only store *.ezpkg files in the 'packages' directory. No subdirectories are supported or allowed. If you use subdirectories your packages will not be detected or imported from local sources.
You should not need to unpack the packages (up to eZ Publish 3.6.12)
Again, make certain the web server (user and group) can read and write to all the files in the package directory.
Start or re-start setup wizard and complete setup normally. Packages should be installed from local sources over remote sources.

Local packages installation is the standard for eZ Publish 3.x through 3.6.12 and setup wizard completion time was acceptable. The setup wizard performance improved over the years / releases and today is very fast indeed (even without using local package installation).

Solutions

External resources

Extended sort

Fri, 09 Dec 2011 12:37:40 GMT

Requirements

For taking proper advantage of this feature you should know something about:

writing an extended_attribute_filter (fetch content list)
SQL
the eZ Publish database layout

Function

There is an undocumented feature in the eZ Publish fetch content list function for sorting on arbitrary sql statements. On regular fetches this feature is not available. However, when including an extended_attribute_filter parameter in the fetch, eZ Publish allows the user to sort on any arbitrary sql clause.

Use

Add an empty 'extended_attribute_filter' parameter in the fetch like this: 'extended_attribute_filter', hash(). Then add a 'sort_by' parameter, like this: 'sort_by', $sql_statement.

The sql string in the $sql_statement variable is inserted directly in the ORDER BY sql clause. Tables included by a regular fetch content list are:

ezcontentobject_tree
ezcontentobject
ezcontentobject_name
ezcontentclass

which means that any fields within these tables can be used in the $sql_statement string. If a sort_by attribute is involved, the ezcontentobject_attribute table are also included.

Furthermore, if required one can add other tables in an extended_attribute_filter's code, giving you access to sort on any field or combination of fields in the database.

Examples

fetch( 'content', 'list', hash( 'parent_node_id', 2,
                                'sort_by', array( 'ezcontentclass.identifier ', true() ),
                                'extended_attribute_filter', hash()
    ) )

This example will sort the resulting node list by the class identifier string. Note that this will not work if the extended_attribute_filter parameter is not included.

fetch( 'content', 'list', hash( 'parent_node_id', 2,
                                'sort_by', array( ' RAND() ', true() ),
                                'extended_attribute_filter', hash()
    ) )

This example will give a randomized list of nodes. This is not possible to do without the extended sort feature.

fetch( 'content', 'list', hash( 'parent_node_id', 2,
                                'sort_by', array( array( 'cast( a0.data_text as unsigned )', true() ),
                                                  array( 'attribute', true(), 'article/select_attribute' ) ),
                                'extended_attribute_filter', hash()
    ) )

This sorts an attribute of the selection datatype in the article class by the selection id as a number (and not by selection id as a string, as is default for this datatype, which makes the sort fail on id's above 9). The second sort element tricks the fetch into including the ezcontentobject_attribute table in the sql, named as a0, but will not have any effect on the actual sorting.

fetch( 'content', 'list', hash( 'parent_node_id', 2,
                                'sort_by', array( 'obj.name ', true() ),
                                'extended_attribute_filter', hash( 'id', 'ObjectRelationSortFilter',
                                                                   'params', hash( 'relation_attribute_id', 337,
                                                                                   'related_class_attribute_id', 343 ) )
    ) )

Here is an example on how to sort the nodes by an attribute of the related objects in an object relations attribute.

This example requires an extended_attribute_filter to include the right tables, the main function of the code for this follows...see the extended_attribute_filter documentation for setting up this.

function sqlObjectRelationSort($params)
    {
        $sqlTables= ", ezcontentobject_tree AS node
                LEFT JOIN ( ezcontentobject_link AS link, ezcontentobject AS obj, ezcontentobject_attribute AS attr )
                ON ( node.contentobject_id = link.from_contentobject_id AND
                    node.contentobject_version = link.from_contentobject_version AND
                    link.contentclassattribute_id = {$params['relation_attribute_id']} AND
                    link.to_contentobject_id = obj.id AND
                    obj.id = attr.contentobject_id AND
                    obj.current_version = attr.version AND
                    attr.contentclassattribute_id = {$params['related_class_attribute_id']} )";
 
        $sqlJoins = ' ezcontentobject_tree.node_id = node.node_id AND ';
 
        return array( 'tables' => $sqlTables, 'joins'  => $sqlJoins, 'columns' => '' );
    }

As you see, this filter requires two parameters. relation_attribute_id is used to specify the attribute id of the object relation. related_class_attribute_id is used to specify the attribute id of the related object that is to be sorted on. This function requires that all nodes are of the same class, and all related objects in the specified object relation attribute are of the same class.

This can potentially be further expanded to sort on the attributes of the children of the nodes. This is left as an excercise for the reader.

Debugging

Whenever developing extended_attribute_filters or extended sorting, switch on the SQL output in the debug in settings/override/site.ini.append.php:

[DatabaseSettings]
 
SQLOutput=enabled
 
[DebugSettings]
 
DebugOutput=enabled

If you can't immediately see what is wrong, copy the complete sql statement from debug and paste it into your favourite SQL program. It is a lot easier to make the sql work there than to test it against eZ Publish.

OpenSearch

Tue, 29 Nov 2011 02:49:12 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

Introduction

With the recent addition of open search plugins to Firefox and Internet Explorer web browsers can now share the same search plugins!

This means Internet Explorer, Firefox and other browsers can now share search plugins written using the OpenSearch Standard.

Open Search plugins are simple files in xml format and the new standard for cross browser search plugins.

Plugins

The following list has to be ordered alphabetically. Keep this in mind when adding items to it.

The following search plugins can be used to quickly search for specific eZ publish information on share.ez.no and eZpedia.org. These plugins are licensed under the GNU GPL, feel free to reuse these as examples for your own search plugins.

Installation

Click the install button next to the search plugin text link.

Update

We are uncertain at the time of publishing, of the best way to update an installed search plugin.

To date the best method is the removal of the search plugin file in the browser. In firefox you may do this by removing the file on disk (same name), restarting the browser and installing the plugin again.

Usage

After installation, select the search plugin from the dropdown list in the upper right hand corner of your browser and enter a search query.

Using these with eZ publish

The install buttons on this page are a custom tag which accepts the plugin url as an argument passed to the custom tag template which contains the browser form button installation javascript.

<input type="button" value="Install" onclick="javascript:window.external.AddSearchProvider('https://raw.github.com/brookinsconsulting/opensearch/master/ezc/ezpedia.xml');" />

Support

Forum: OpenSearch Plugin Development

Browsers

Firefox 2.0
Opera 9.0
Internet Explorer 7.0

Credits

These search plugins, documentation, solution are a direct result of the eZpedia community documentation project, Kristof Coomans and Graham Brookins.

Initial Implementation - Kristof Coomans

Copy and Pasting aka Development - Graham Brookins

License

' GNU GPL'

Copyright

External reference

Testing eZ Publish - Test System

Thu, 24 Nov 2011 13:25:38 GMT

Warning

The test system is considered ever evolving and backwards incompatible changes may occur. We do invite you to start writing tests for it, just be warned that the tests may need some updating as we evolve the system.

Getting started

Requirements

PHPUnit 3.5.x or newer: https://www.phpunit.de/
eZ Components

Installation

Start with a clone of the github repo (updated to at least 30/9/2008 - svn trunk rev 22408or github commit 530f3ad97ba5abecc19474baad92e8effd12d6d3)
To run the tests in another eZ installation, copy into it the "tests" folder from the github installation
Generate autoloads for the test system:

php bin/php/ezpgenerateautoloads.php -s

Running tests

To run all tests do:

php tests/runtests.php --dsn mysql://root@localhost/testdb

The --dsn parameter is required and is used to tell the test system what type of database, username, host and which database to use. Make sure the username you specify is allowed both create and remove the database. The DSN uses the following format:

databasetype://username:password@host/database

Note: do not use an existing eZ Publish database for running tests, as it will be wiped out and recreated on need by the tests!

If you want to run a single test suite, just point to the directory containing a suite.php file.

php tests/runtests.php --dsn mysql://root@localhost/testdb tests/tests/lib/ezdb

Filter which tests to run

To run a single test you can use the --filter option like this:

php tests/runtests.php --dsn mysql://root@localhost/testdb --filter=testGlobBrace

In the above example both eZSysTest::testGlobBrace and eZSys::testGlobBraceSupported will be executed. If you only want to execute eZSysTest::testGlobBrace run:

php tests/runtests.php --dsn mysql://root@localhost/testdb --filter="testGlobBrace$"

This works too:

php tests/runtests.php --dsn mysql://root@localhost/testdb --filter="eZSysTest::testGlobBrace$"

As of PHPUnit 3 --filter can also be used to filter on test class names. This is a handy way of running all tests in a test case. Example:

php tests/runtests.php --dsn mysql://root@localhost/testdb --filter="eZSysTest"

List tests

To list all test use the --list-tests option:

php tests/runtests.php --list-tests

You can also narrow the output to only list tests defined in a specific suite:

php tests/runtests.php --list-tests tests/tests/lib/ezutils

Running a group of tests (group annotation)

With PHPUnit you can group different tests together by adding the group annotation to a method's documantion block:

To list all groups run:

php tests/runtests.php --list-groups

To run a group use the -g parameter:

php tests/runtests.php --dsn mysql://root@localhost/testdb -g issue_13492

Writing tests

Naming conventions

The test system itself follows eZ Components naming conventions defined here: https://ezcomponents.org/contributing/coding_standards#id8.

The tests itself follows the naming conventions of the code that it tests. In this case this means the tests follows the eZ Publish naming convention.

File and directory layout

The file structure used in eZ Publish is mirrored inside the test system. As an example, if you want to write tests for kernel/classes/ezcontentobject.php the test file should be located in tests/tests/kernel/classes/ezcontentobject_test.php. Regression tests for ezcontentobject should be located in tests/tests/kernel/classes/ezcontentobject_regression.php

*_test.php is the suffix used for unit tests. *_regression.php is used for as the suffix for regression tests.

Writing a unit test

The test system comes with a handy CLI script for generating stub tests from an existing class to get you going quickly. As an example, you can generate a stub test from kernel/classes/ezpreferences.php like this:

php tests/toolkit/extras/scripts/create-test-from-class.php \
               -s kernel/classes/ezpreferences.php \
               -d tests/tests/kernel/classes/ezpreferences_test.php

The generated tests/tests/kernel/classes/ezpreferences_test.php file will then look like this:

<?php
 
class eZPreferencesTest extends ezpTestCase
{
    public function __construct()
    {
        parent::__construct();
        $this->setName( "eZPreferences Unit Tests" );
    }
 
    public function testSetValue()
    {
        self::markTestIncomplete( "Not implemented" );
    }
 
    public function testValue()
    {
        self::markTestIncomplete( "Not implemented" );
    }
    // [...]
}
?>

To make the new test case work we need to add it to the appropriate suite.php. For this test case that is tests/tests/kernel/suite.php. Add

$this->addTestSuite( 'eZPreferencesTest' );

to the __construct method of eZKernelTestSuite and remember to regenerate test autoloads. To verify that the new test case is working run 'runtests.php' with -v:

oh:/www/trunk $ php tests/runtests.php -D mysql://root@localhost/testdb -v 
Based on ezcUnitTest in eZ Components
 
PHPUnit 3.3.0 by Sebastian Bergmann.
 
eZ Publish
 eZ Publish Test Suite
  eZ Publish Kernel Test Suite
   eZPreferencesTest
   IIIIIIII
 
[...]

Success! We're now ready to start writing the test by filling in the test* methods.

Normally tests are short and straight forward and should require little or no documentation. Due to the complexity of eZ Publish not all tests ends up being in this way. If you are writing a somewhat complex unit test, please document it a way that makes it easier to understand.

Writing a regression test

Regression tests are created in the same way as with unit tests, except the classes end with "Regression" and the file suffix is _regression.php. When writing a regression test please document it with the following:

Issue number + title of the issue.
Short description of the issue if the title isn't descriptive enough.
If the test is longer than a few lines, include what the test does in order to reproduce the issue.
The result and the expected result.
Link to the issue.

Here's a doc header example taken from testLinksAcrossTranslations():

/**
 * Test scenario for issue #13492: Links are lost after removing version
 *
 * Test Outline
 * ------------
 * 1. Create a Folder in English containing a link (in the short_description attribute).
 * 2. Translate Folder into Norwegian containing another link (not the same link as above.)
 * 3. Remove Folder version 1. (Version 2 is created when translating).
 *
 * @result: short_description in version 2 will have an empty link.
 * @expected: short_description should contain same link as in version 1.
 * @link https://issues.ez.no/13492
 */

If the issue has multiple tests group them together to make it easy to execute all tests for a single issue using the group annotation "@group issue_ISSUE_NUMBER" where ISSUE_NUMBER is the issue ID in the bug tracker. Example:

* @group issue_13492

Using a database

A common thing for tests is to interact with a database. By extending your test class or suite from either ezpDatabaseTestCase or ezpDatabaseTestSuite your test class/suite will become database aware. By default ezpDatabaseTestCase and ezpDatabaseTestSuite sets up a clean database using the dba files included in eZ Publish:

share/db_schema.dba
share/db_data.dba

Inserting your own data

If you need to provide your own schema/data you can override which SQL files is loaded by ezpDatabaseTestSuite by specifing the path to one or more SQL files in the $sqlFiles class method:

Example:

class eZURLAliasMlTest extends ezpDatabaseTestCase
    {
        protected $insertDefaultData = false;
        protected $sqlFiles = array( array( "kernel/sql/", "kernel_schema.sql" ),
                                             "kernel/sql/common/cleandata.sql" );
        // [...]
    }

Setting $insertDefaultData to false tells the test system that it should not attempt to load any data. If $insertDefaultData is not defined or if it's set to true the test system will first load the default data, then load any SQL files defined in $sqlFiles.

The first entry in $sqlFiles, array( "kernel/sql/", "kernel_schema.sql" ) is a way to provide a SQL file for one or more of the supported database types. If you're using MySQL, the test system would try to insert kernel/sql/ mysql/kernel_schema.sql. If the database type is postgresql, the test system would try to insert kernel/sql/ postgresql/kernel_schema.sql, and so forth.

The database type is determined by the -D (--dsn) parameter provided to the test runner.

Note: you can specify $sqlFiles on either your test class or in your suite. The default test runner behaviour is to only create a new database per suite. If you provide $sqlFiles in your test classes you will need start the test runner with the --db-per-test argument.

Providing extra data

In the above exampe we discussed how to override what data gets initially loaded into the test database. If all you need is to provide some additional data you can leverage the ezpTestDatabaseHelper class to load some extra SQL files:

$sqlFiles = array( "myextension/sql/data.sql" );
ezpTestDatabaseHelper::insertSqlData( $this->sharedFixture, $sqlFiles );

Writing tests for an extension

Extensions can include their own tests. When running tests the test runner will not only look for tests inside the tests/ directory, it will also scan each extension looking for a tests/suite.php file inside the extension. The extension does not need to be in the list of active extension (ActiveExtensions[] in site.ini) for it to be included.* The only critera for the extension to be included is that is has a folder "tests/" with a suite.php inside. The suite.php should then include all tests in the extension. Below is an example of a typical extension file layout and where the tests should be located:

extension
    |-- myextension
        |-- autoloads
        |-- design
        |-- modules
        |-- settings
        |-- tests
        |   |-- mytest1.php
        |   |-- mytest2.php
        |   `-- suite.php
        `-- translations

You can specify the path to an extension to only run tests for that extension:

php tests/runtests.php --dsn mysql://root@localhost/testdb extension/myextension

* Remember that you still might need to regenerate the autoload array for the extension depending on how it's built.

One database per suite

Currently, the default behaviour is that a database is created per suite, not per test. Creating/removing the database easily adds 1-2 seconds of overhead per test on the database management systems that eZ Publish supports out of the box (MySQL, PostgreSQL). However, there's an extension ezsqlite which allows you to use an in-memory SQLite 3 database to run the tests with.

If you pass in the argument --db-per-test to the test runner it will change from the default behaviour, one database per suite, to one database per test. It's strongly encouraged that you write tests that works with both --db-per-test turned on and off.

To illustrate the difference in speed, below is how long it takes to run all tests with --db-per-test:

php tests/runtests.php --dsn mysql://root@localhost/testdb --db-per-test
PHPUnit 3.3.0 by Sebastian Bergmann.
 
............................................
 
Time: 01:48
 
OK (44 tests, 99 assertions)

And without --db-per-test:

php tests/runtests.php -D mysql://root@localhost/testdb
PHPUnit 3.3.0 by Sebastian Bergmann.
 
............................................
 
Time: 19 seconds
 
OK (44 tests, 99 assertions)

Resources

Testing eZ Publish

Fri, 30 Sep 2011 00:24:51 GMT

Description

There exists two primary ways to create and perform automated testing on eZ Publish

Code testing with unit test suite

eZ publish includes a php test suite for unit tests available only from the eZ Publish subversion repository, /trunk/tests. With this test suite we test if functionality in eZ publish still works when we add a new feature, fix a bug, or before we make a new release. For more about this test suite read, eZ publish Test Suite.

Application testing with Selenium

You can create amazing browser based tests with Selenium.

There used to be a great article on Testing eZ Publish with Selenium on ez.no before the split of share.ez.no. Now all that remains is the demo code on projects.ez.no: https://projects.ez.no/article_testing_ez_publish_with_selenium.

A cool extension to automate functional testing with eZ Publish: https://projects.ez.no/eztestbrowser (and accompanying article in italian: https://www.cphp.it/2009/07/18/test-funzionali-su-ez-publish-con-phpunit-e-sfwebbrowser/)

References

Doc: eZ Publish Test System

eZ Webin ezpagedata template operator

Fri, 05 Aug 2011 13:45:04 GMT

Background

In the early releases of the eZ Website Interface extension (eZ Webin), the pagelayout.tpl file was packed with calculations on which blocks to include where etc. This made quite a messy and suboptimal pagelayout.tpl.

To rectify this, eZ Systems moved a lot of this logic into a new general purpose template operator. This operator combines parameters from the view template, the ini system and the Template Look object, and returns an array of information the pagelayout.tpl template can use.

Unfortunately, they forgot to document it...

eZ Webin template operators

List of template operators included in eZ Webin:

ezpagedata( array $params ) - returns general page parameters to be used in pagelayout.tpl
ezpagedata_set( string $key, mixed $value ) - set persistent value for pagelayout, to be used in view templates
ezpagedata_append( string $key, mixed $value ) - append persistent value to array for pagelayout, to be used in view templates

The persistent_variable is originally only supported in the content view full module/view (the rationale is that the view cache takes effect only here). These template operators extends the support to other modules/views as well.

ezpagedata() template operator

Note: The parameter $params of this operator is an array that is merged with persistent_variable to produce the resulting hash. So if needed you can influence the results directly from pagelayout.tpl.

The return value is a hash that may currently contain the following elements:

persistent_variable - standard persistent variable from $module_result.content_info.persistent_variable
show_path - indicates if path should be shown
website_toolbar - indicates if website toolbar should be shown
node_id - specifies current node id
is_edit - indicates if we are in edit mode
page_root_depth - specifies the depth of the root node
page_depth - specifies the depth of the current node
root_node - specifies the node id of the root node
template_look - the template look content object
class_identifier - specifies the class identifier of the current node, same as $module_result.content_info.class_identifer
top_menu - template name for the top menu
left_menu - template name for the left menu
current_menu - identifier of the current menu
extra_menu - indicates whether extra column (right column) should be shown
extra_menu_node_id - indicates node id of node to use in extra column, default is current node
extra_menu_subitems - indicates number of sub items in extra column
extra_menu_class_list - list of classes to be used in extra column
path_array - list of nodes to be used in path
path_id_array - list of node ids to be used in path
path_normalized - normalized string of path identifiers
css_classes - string of CSS classes to be set in the <div id="page"> tag

Disclaimer: Note that there may be differences between different versions of eZ Webin. This list is based on an eZ Webin v.1.7 codebase.

Values of hash elements

The criterias for the values of the different pagedata() hash elements can be quite complex. The following is a partial list of the elements and the order in which the different values are set for each element. In this illustration line 1 is default value, line 2 takes precedence over line 1 if specified, etc.

Template look

pagedata.template_look

$persistent_variable['template_look']
Fetch first object of class identifier specified in $persistent_variable['template_look_class'] (by default it is the string 'template_look')

Current menu

pagedata.current_menu

menu.ini [SelectedMenu] CurrentMenu=<menu_name>

Top menu

pagedata.top_menu

menu.ini [SelectedMenu] TopMenu=<template_name>
$persistent_variable['top_menu']

Left column/menu

pagedata.left_menu

menu.ini [SelectedMenu] LeftMenu=<template_name>
$persistent_variable['left_menu']
$hideMenuClasses != false
menu.ini [MenuSettings] AlwaysAvailable == false && (.is_edit || 'content/versionview' || current_node_id == false || uicontext 'browse')

Note: .left_menu specify if .css_classes contains 'sidemenu' or 'nosidemenu'

Extra column/menu

pagedata.extra_menu

'extra_info'
$persistent_variable['extra_menu']
$hideMenuClasses != false

pagedata.extra_menu_node_id

current_node_id
$persistent_variable['extra_menu_node_id']

pagedata.extra_menu_class_list

array( 'infobox' )
$persistent_variable['extra_menu_class_list']
menu.ini [MenuContentSettings] ExtraIdentifierList=<class_identifier_list>

pagedata.extra_menu_subitems

0
$persistent_variable['extra_menu_subitems']
Count of number of sub items in top level of content tree, based on .extra_menu_node_id and .extra_menu_class_list?

Note: If .extra_menu_subitems is false, .extra_menu will also be set to false.
Note: .extra_menu specify if .css_classes contains 'extrainfo' or 'noextrainfo'

Simple fromString and toString interface for attributes

Thu, 23 Jun 2011 14:57:27 GMT

Simple fromString and toString interface for attributes

This is a copy of only document available that describes the extremely useful toString and fromString functions of datatypes, which greatly simplify storing and retrieving attributes in php.

This is a design document, so there may be some inaccuracies but it seems to work ok into the 4.2 series. It is recommended to verify the format of not-trivial datatypes by doing toString on attribute of that type with data in it and examining output.

Source: https://pubsvn.ez.no/nextgen/trunk/doc/features/3.9/to_from_string_datatype_functionality.txt

To simplify writing of import export scripts we have added two functions to the ezcontentobjectattribute class. Also related functions with the same name have been added to the datype interfase and to all datatypes in standard eZ Publish distribution exept of ezenum which is now deprecated and ezpackage which is not used.

To show possibilities of these functionality two scripts have been added under bin/php/. These scripts are very simple CSV import/export scripts:
- ezcsvimport.php
- ezcsvexport.php
They are very basic and do not pretend to be fully functional CSV import/export for ezpublish though you can use them to do real import/export. Here is a description of formats which are accepted by the datatypes for
fromString( &$contentObjectAttribute, $string ), and generated by toString( $contentObjectAttribute ) methods.

ezauthor:
To separate one author from another '&' char is used, to separate parts of author data '|' is used. The system escapes '|','&','\' with the '\' char.
Example of toString result:

To make it easy to parse such kind of strings the class ezstringutils is added under lib/ezutils. It has to functions as a members.
explodeStr( $str, $delimiter = '|' ) and implodeStr( $str, $delimiter = '|' ). The first one explodes string to an array with delimiter char, the difference from PHP explode/implode is that these functions do propper escaping/unescaping of all values.

ezbinaryfile:
toString function of this datatype return string of format:
filepath|original_filename
filepath is to a file in filesystem so you can make copy of the file.
original_filename is the original filename of uploaded file as string.
To import binary file to the attribute you need to supply it with full path
to the source file, which will be copied into system.

ezboolean:
Returns and accepts 1 or 0 for true and false accordingly.

ezcountry:
Returns comma-separated list of selected countries locale strings, ex.:
rus-RU,eng-GB,nor-NO

ezdate:
Returns and accepts unix timestamp of the date.

ezdatetime:
Returns and accepts unix timestamp of the date.

ezemail:
Returns and accepts email address.

ezenum:
Not supported (deprecated)

ezfloat:
Returns and accepts float number.

ezimage:
Returns path to file containing original alias (size) of the image, so it can be copied. Accepts full path to original image you want to import, it will be copied into system.

ezinisetting:
Returns and accepts value of an inisetting.

ezinteger:
Returns and accepts integer value.

ezisbn:
Returns and accepts ISBN number as string

ezkeyword:
Returns and accepts comma separated list of keywords.

ezmatrix:
Identical to ezauthor datatype. The columns are sparated with '|' and rows are separated with '&'

ezmedia:
toString function of this datatype return string of format:
filepath|original_filename
filepath is to a file in filesystem so you can make copy of the file.
original_filename is the original filename of uploaded file as string.
To import binary file to the attribute you need to supply it with full path
to the source file, which will be copied into system.

ezmultioption:
The first '&' separated value is the name of multioption set, then each '&' separated string represents
each option in multioption set. This string it self is '|' separated value, that consist of, in this order:
_name_ of the option and the _id_ of option item which should be selected by default. After these two
values we have option_value and additional price for the option item.

ezmultiprice:
The structure of a data handled by this data type is
currency_name_1|value_1|type_of_price_1|currency_name_2|value_2|type_of_price_2|......currency_name_n|value_n|type_of_price_n|
Where currency_name is thre char currency name like EUR,USD and so on,
value is the price in this currency,
and type can be AUTO or CUSTOM dependin on if the price in this currency
has been inserted by user or calculated automaticaly.

ezobjectrelation:
Returns and accepts ID of related object.

ezobjectrelationlist:
'-' separated list of related object ID's.

ezoption:
'|' separated list of name of the option and then | sparated list of option_item|additional item price values.

ezprice:
'|' separated list of price, VAT id, and flag wether VAT is included to the price or not.

ezproductcategory:
Returns '|' separated string with product category name and category id. Accepts just category
name as a papameter.

ezrangeoption:
'|' separated string contains name of the option, start,stop and step values for the option.

ezselection:
'|' separated list of selected item names.

ezstring:
Returns and accepts the string value.

eztext:
Returns and accepts the string value of eztext field.

eztime:
String with the time of the day in HH:MM , 24h format

ezurl:
string containing the url or a url|text

ezuser:
'|' separated string with user login, email, password hash, and password hash type.

ezxmltext:
Returns valid ez publish xml, and expects the same as input.

Cronjob

Fri, 25 Mar 2011 15:34:39 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

Cronjobs are useful for periodic tasks like updating content, sending emails (notification) and so on. But they are also useful for tasks that have a long runtime which you want to make sure that the execution timeout does not affect the script. This is typically used for import-scripts.

The main reason for implementing a import-script or similar as a cronjob is that implementing a cronjob is drastically simpler than a cli script.

What is a cronjob

Cronjobs are tasks that are run at regular intervals. See Wikipedia for a more detailed description. See also the cronjobs documentation on ez.no.

Cronjob vs CLI scripts

Cronjob and CLI scripts are similar in the way that they are both run from the command line. However, there are two important differences between CLI scripts and cronjob scripts:

CLI scripts can have parameters, while cronjob scripts cannot take any parameters
Cronjob scripts set up the environment for you. That means creating a connection to the database, activating a siteaccess and activating extensions. If you implement a CLI script, you need to do all of this yourself.

Examples of CLI scripts are located in ./bin/php/*.php

Examples of Cronjob scripts are located in ./cronjobs/*.php

Implementing a cronjob

In this example, we implement a simple cronjob to import content. To implement this cronjob in an extension we need the following structure:

extension/myimport
|-- cronjobs
|   `-- import.php
`-- settings
    `-- cronjob.ini.append.php

In the cronjob.ini.append.php script we add the following:

[CronjobPart-import]
Scripts[]
Scripts[]=import.php
 
[CronjobSettings]
ExtensionDirectories[]=myimport

In the import.php:

<?php
 
echo "We have liftoff";
 
?>

We activate the extension, and now we can run the script as follows:

php runcronjobs.php -dall import

By using -dall we get the debugoutput, which is very useful for checking php-warnings and other errors.

This is the elements that needs to be in place to have a simple cronjob script. Now you can expand the import.php to do what you want it to do.

Settings

The settings for cronjobs are described in the documentation on ez.no

Running the cronjob

See the documentation on ez.no

References

Examples of simple, basic and advanced cronjobs.
The Cronjob script
Forum: Debugging cronjob php errors
Solution: Running cronjobs.php with parameters in limited environment
Term: cronjobs

List of recommended cronjobs to run

every 10min:
------------------
ezflowupdate (only if you run specific ezflow blocks that need it)

hourly:
----------
notification.php (optional - enable it if you use email notifications)
workflow.php (optional - enable it if you use delayed workflow events)

daily:
---------
ldapusermanage.php (optional - syncs ldap user accounts)
ezfoptimizeindex.php (by night - in extension ezfind)
ezflowcleanup.php

weekly:
--------------
cluster_maintenance.php (by night)
internal_draft_cleanup.php (by night)
old_draft_cleanup.php (by night)
linkcheck.php (optional - removes invalid links)
unlocked.php (by night)

Optional:
-------------
- the script ezasynchromouspublish

- cronjobs in extension ezcomments (if you use it)

Cron Jobs Alternatives

Some hosting companies don’t allow access to cron, but you can find a lot of cron jobs alternatives which are free or paid.
Here are some services:

Cache

Fri, 31 Dec 2010 10:06:33 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

For a general description of cache, we recommend cache on Wikipedia.

Types of cache in eZ Publish

eZ publish uses several caches to improve performance:

Cache Name	Short Description	Update
Content view cache	Cached node result.	On publish
Global INI	Recursively removes settings cache. Removes all files under var/cache/ini	On change (auto)
INI cache	Recursively removes settings cache. Removes all files under var/<sitefolder>/cache/ini	(auto)
Codepage cache	Removes the char translation tables. Recursively removes all files under var/<sitefolder>/cache/codepage	??
Expiry cache		On expire (auto)
Class identifier	Recursively removes all files under var/<sitefolder>/cache based on a regular expression.	Auto
Sort key cache	Recursively removes all files under var/<sitefolder>/cache based on a regular expression	Auto
URL alias cache	Cache contains a mapping of node urls to node ids. Recursively removes all files under var/<sitefolder>/cache/wildcard	Auto
Character transformation cache	Cache contains character mapping for url generation, search keywords translation and other. Recursively removes all files under var/<sitefolder>/cache/trans	?
Image alias	Cache contains all system generated image aliases ( resized images based on uploaded image ). Clearing that cache causes all images to get re-created.	Auto unused alias are never remove
Template cache	Included templates get cached. When using a lot of template includes that cache directory can contain a lot of files ( {include uri...}in template laguage ). Recursively removes all files under var/<sitefolder>/cache/template	Auto/manual
Template block cache	Cache contains all cache blocks ( {cache-block...}in template laguage ). Recursively removes all files under var/<sitefolder>/cache/template-block	Every 2 hours or when content expire
Template override cache	Cached version of the override.ini configuration file. Recursively removes all files under var/<sitefolder>/cache/override
RSS cache	Recursively removes all files under var/<sitefolder>/cache/rss (often xml files)	Check setting file
User info cache	Cache contains user permission. Recursively removes all files under var/<sitefolder>/cache/user-info

Additional cache types in eZ Publish

Clearing cache in eZ Publish

You can clear several caches with the setup/cache view or with the command line script bin/php/ezcache.php.

Solution: Clear Cache on eZ Publish

Additionally, you can configure eZ publish to accommodate further web caching.

References

Solution: Template Development Without Clearing Cache

Humor

Tue, 26 Oct 2010 23:27:42 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

Humorous mentions

Example

Reading individuals venting about eZ Publish on any medium (twitter, irc, forum, im, skype, face to face)

External References

Forum: eZ LolCats
Forum: Woefully complex upgrade process
Forum: Cease and desist
Forum: A non-loss in the family ...
Forum: Advice...Should I use eZ Publish?
Forum: ezwebin design orignal photoshop/gimp files

Cluster

Wed, 01 Sep 2010 09:12:24 GMT

For a general description of cluster, we recommend cluster on Wikipedia.

This is a Stub article. Help the eZ Publish community by expanding it!

About

Their are several publicly available cluster solutions available for hosting eZ Publish.

References

Documentation
- Clustering feature
Articles
- Clustering in eZ publish 3.8
Blog: Experiences using clustering with eZ publish 3.8
Bertrand Dunogier's presentation : eZ Cluster unleashed

AMF

Sun, 25 Apr 2010 17:01:58 GMT

About

Flash Remoting support for the Action Message Format (AMF is a based binary format in SOAP).
AMF protocol support can be provided by jvAMF extension (based on Zend_AMF component).

Please refer to the documentation of the extension for extended details.

References

Flash remoting for PHP: Zend_AMF, amfphp.org
Forum: Macromedia Flash + Ezpublish :: expanding possibilities
jvAMF Extension

Amazon

Tue, 02 Mar 2010 09:28:32 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

eZ Publish can be used with an Amazon API(s)

Extensions

JV Amazon Advertising allows you to query Amazon huge product catalog by using Amazon Product Advertising API

https://projects.ez.no/jvamazonadvertising

IB Amazon Website Integration extension allows you to integrate products from Amazon with your site. After enabling this extension you've got an oportunity to search products on Amazon using a keyword and product category selection.

https://ez.no/developer/contribs/solutions/ib_amazon_website_integration

xrowCDN connects eZ Publish with a Content Delivery Network

https://projects.ez.no/xrowcdn

Known Issues

References

Install

Fri, 19 Feb 2010 00:13:08 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

Helpful information about installing the eZ Publish CMS

Articles

References

eZ publish 3.9

Fri, 29 Jan 2010 18:36:29 GMT

News on ez.no

2007-02-22	eZ publish 3.9.1 RC1 released
2007-01-10	Unofficial info	eZ publish 3.9.1 expected in about two weeks, containing a security fix ( bug #9942 )
2006-12-18	Anouncing eZ publish 3.9.0 with the new Website Interface
2006-12-07	RC2 released
2006-11-17	Community newsletter 17/11/2006	release of 3.9.0 expected mid December
2006-11-14	RC1 released
2006-10-30	beta1 released
2006-10-18	alpha1 released
2006-10-06	Community newsletter 06/10/2006	finishing up implementation, included features are certain
2006-06-16	Community newsletter 16/06/2006	updated feature request list
2006-05-24	feature request list

Installation

We recommend to use the setup wizard to perform a new installation of eZ publish 3.9 when you want to use the new Website interface design, because there are some difficulties and inconsistencies with the manual installation procedure. The brave ones can always try to do a manual installation. Please read the 3.9 manual installation forum topic and add your experiences and good advice to it.

Upgrading

Follow the upgrade instructions at ez.no. Carefully read the comments too! They contain some important remarks!

Because of bug #9873 and bug #9952 we recommend you to wait for eZ publish 3.9.1 to upgrade existing sites.

Using old site packages

The site packages used in versions prior to eZ publish 3.9 still can be used for eZ publish 3.9. If you want to use the old site packages instead of the new ones, then add the following settings to settings/override/package.ini.append.php before you start the setup wizard:

[RepositorySettings]
RemotePackagesIndexURL=https://packages.ez.no/ezpublish/3.9legacypackages

New features

Most new features are described in the 3.9 feature docs.

Website interface extension

There's a new site package called Website interface. It is possible to override the default website interface.

Class and template editing are disabled by default since the 3.9.0 release. A solution to this problem is to modify SiteAccessRules to allow advanced editing.

Additional content creation and import features

CSAPI function for quick object creation and publishing. In addition to the toString and fromString datatype functionality.

A function eZContentFunctions::createAndPublishObject was added to the file, kernel/classes/ezcontentfunctions.php (trunk rev. 17475).

This function allows to easily create an object, populate its attributes with data and publish the object at one node location.

The best information available apears to be in the new feature documentation in svn trunk and the source code itself.

See: ezcontentfunctions.php, ezcsvimport.php, ezcsvexport.php

Best Selling Product Fetch

There's also a new extended fetch function providing best selling product information through, 'best_sell_list' fetch function.

Kernel Error Codes

A smaller addition is the new kernel error code values now available.

Setup wizard finish custom text

Site packages can now specify custom text to be shown at the finish screen of the setup wizard (trunk rev. 17478).

Contributor / third party software / extension information

The ezinfo/about view now includes information about contributors, included third party software and the enabled extensions.

Information about contributors is extracted from the source code headers by the updatelicense.sh distribution script and assigned to the variable $contributorSettings in PHP files under var/storage/contributors.

Information about third party software is also extracted from the source code headers and assigned to the variable $thidPartySoftware in var/storage/third_party_software.php.

Extensions can now provide extension information to be displayed on the ezinfo/about view.

External resources

New Interface in eZ publish 3.9
eZ publish now (3.9) demo

Import

Fri, 29 Jan 2010 18:32:25 GMT

CSV / DSV

Extensions doing CSV import:

Additional content creation and import features

eZ publish 3.9 comes with new features which make CSV import easier.
CSAPI function for quick object creation and publishing. In addition to the toString and fromString datatype functionality.

A function eZContentFunctions::createAndPublishObject was added to the file, kernel/classes/ezcontentfunctions.php (trunk rev. 17475).

This function allows to easily create an object, populate its attributes with data and publish the object at one node location.

The best information available apears to be in the new feature documentation in svn trunk and the source code itself.

See: ezcontentfunctions.php, ezcsvimport.php, ezcsvexport.php

OpenDocument

Extensions doing OpenDocument import:

OASIS Open Document extension

PowerPoint

see PowerPoint Import

RSS

See RSS.

OPML

See OPML.

XML

Extensions doing XML import:

Import XML Data

Import Framework

Basic classes for abstracting data imports.

Misc

Extensions doing other kinds of import:

References

Payment Gateway

Wed, 28 Oct 2009 11:27:58 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

There are many payment gateway service support available for eZ Publish.

Stable

Authorize.net - Use eZ authorize extension
eCart - Use eCard payment gateway extension
Fianet - Use eZ Fianet connector extension
Mercanet - Use eZ Mercanet extension
Ogone - Use eZ Ogone DirectLink & Subscription extension
Paynet - Use Paynet extension
Paypal - Use eZ paypal extension
Protx - Protx Payment Gateway extension or another proxt extension
Worldpay - Worldpay payment gateway extension
Invoice - Supported in eZ publish by default
Securepay - Use eZ securepay hack of eZ authorize (email kracker)
Iclear - Iclear payment extension
eZSips - Atos Origin SIPS payment gateway extension
eZ Cybermut Payment gateway for Cybermut extension
TeleCash - extensionTeleCash payment gateway
Firstgate/Click&Buy - Firstgate/Click&Buy Payment Gateway Extension
Comdirect / Coposweb gateway for eZ Publish - Part of xrowecommerce
DIRECTebanking v2.0 and DIRECTebanking.com - Paycode v1.0

Ideas

Google Checkout - I've heard of this being asked for in passing
Paypal Pro - I've also heard of this being asked for more directly.
Subscription Payment Gateway Extension
In Development: Saferpay.de Gateway

Experimental

Someone outlined Amazon support in the forums, it would be useful to see a packaged extension based on this contribution.

External reference

Forum: Payment Gateway Type
Forum: Documentation on payment gatways and workflows
Forum: Payment Gateways Pack: eZ integration with major providers
Forum: Payment gateway depending on shopaccounthandler selection
Forum: Payment gateway options based on Price

Workflow event type

Fri, 09 Oct 2009 17:45:40 GMT

Location

In the kernel, workflow event types are located in kernel/classes/workflowtypes. In extensions, custom workflow events are located in the eventtypes directory.

Extensions

How to add your own workflow event type(s) in an extension?

workflow settings file path: myextension/settings/workflow.ini.append.php
- setting: [EventSettings] ExtensionDirectories[]= myextension
- setting: [EventSettings] AvailableEventTypes[]=event_ myevent
design settings path: myextension/settings/design.ini.append.php
- setting: [ExtensionSettings] DesignExtensions[]= myextension
PHP file path: myextension/eventtypes/event/ myevent/ myeventtype.php
PHP class name: MyEventType
template for workflow event edit: design/standard/templates/workflow/eventtype/edit/event_ myevent.tpl
template for workflow event view: design/standard/templates/workflow/eventtype/view/event_ myevent.tpl

(the bold text represents the variable parts of the names, you should alter them for your extension)

Your event type class

Your own event type class needs to extend eZWorkflowEventType. After your class definition, you also need to register it in the system.

include_once( 'kernel/classes/ezworkflowtype.php' );
 
class MyEventType extends eZWorkflowEventType
{
    const WORKFLOW_TYPE_STRING = "myevent";
 
    public function __construct()
    {
        // Set descriptive name
        $this->eZWorkflowEventType( MyEventType::WORKFLOW_TYPE_STRING, 'My event' );
    }
 
    function execute( $process, $event )
    {
        // Do stuff...
 
 
        return eZWorkflowType::STATUS_ACCEPTED;
    }
 
}
 
eZWorkflowEventType::registerEventType( MyEventType::WORKFLOW_TYPE_STRING, 'MyEventType' );

Troubleshooting

If eZ Publish doesn't seem to want to load your workflow event type, then you might want to check out some useful tips to get it to work at the Troubleshooting extensions page.

Question: What documentation about eZ publish do you feel is missing

Wed, 07 Oct 2009 15:35:18 GMT

The Question

I pose this question to the participating members of the eZ publish community.

What documentation, of any type, medium, text/audio/video/interactive/quiz/, kind, etc related to eZ publish do you feel is missing, from the current public offering?

Recommendation for replies: use numbered lists!

Subjects

eZ publish - eZ template Guide (Reference)
eZ publish - eZ xml Guide (Reference)
eZ publish - Pocket Guide (Reference)
API: having an updated (and 100% documentation doxygen)
API: major classes to use and basic exemple (how to create a node/ fetch nodes/move/delete...)
eZ publish - Hacking eZ publish
eZ publish - eZ publish Cookbook
eZ publish - eZ publish Encyclopedia
eZ publish - eZ publish development ('Getting Development with eZ publish') (Advanced Concepts)
eZ publish - Kernel Hooks, Features, Breakdown
eZ publish - Implementation Guide ('What goes where to make eZ go!')
eZ publish - Database Documentation ('Who does what, how and why?','Understanding the eZ publish database data model and primary / foreign key relationships, the eZ way')
eZ publish - Community Contributions (individual, packages) Documentation
eZ publish - eZ and Ajax
eZ publish - SiteDesign Template HTML Default Tab Order
eZ publish - Multiple Sites with or without multiple databases
eZ publish - eZ publish and Subversion (hosting eZ publish site data from svn checkout at production)
eZ publish - SiteDesign as extension (howto + example contribution)
eZ publish - Translated Documentation + Problems Providing Accurate Translations
eZ publish - Operator Documentation
eZ publish - Workflow Documentation
eZ publish - Workflow Event Documentation
eZ publish - Cronjob and CLI Script Documentation
eZ publish - Datatype Documentation (Table of datatypes and uses)
eZ publish - Notifications
eZ publish - User Settings
eZ publish - Using eZ publish functionality (php code) outside of eZ publish itself. Getting Object Information
eZ publish - Comparison with / as a replacement for several dedicated software: blogs, wiki's, image galleries, forums, project management tools (bug systems, ...)
eZ publish - Integrating / connecting to other systems (the ERP plugins, phpBB, ... )
eZ publish - migrating from other systems (Wordpress, ...)

Things already covered

I think we need to discuss with the official doc team first, to know what they want to cover.

In my mind, the first two points (template and xml) are covered by the official doc. If things are missing, I don't think an external doc should fix it, but that should be done within the main doc (might be usefull to open it more to the community, otherwise, comments).

Not find documentation

Whether there are some documentation, I don't know where to look. Currently I'm studying EzPublish extensions, but I don't found yet any documentation about Module Hooks functionallity and implementation

Oracle

Thu, 10 Sep 2009 14:22:36 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

eZ Systems offers an Oracle extension for eZ Publish

External references

Documentation: https://ez.no/doc/extensions/database
Download: https://projects.ez.no/ezoracle/downloads
News: https://projects.ez.no/ezoracle/news
Very old News: eZ Publish Extension for Oracle® Database released under Open Source License ...
Forum: Problems with ezoracle extension installation
Forum: ezoracle extension
Forum: Connection to DataBase out eZ
Forum: PostgreSQL support, is it a yes or no?
Forum: eZpublish Database Extension and Oracle Express Edition

eZ Publish

Sun, 23 Aug 2009 18:35:18 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

For a general description of eZ Publish, we recommend, eZ Publish on Wikipedia.

About

eZ Systems website ez.no is a primary source of resources related to everything eZ Publish.

Install

Checkout this article about Installation it has great 3rd party articles about installing eZ Publish.

Vendors

eZ systems is the creator and primary supplier of eZ Publish software and services. eZ Systems has a number of partners worldwide which also offer additional services, software and support.

Articles

None

References

None

Community

Sun, 23 Aug 2009 10:02:14 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

For a general description of community, we recommend Community on Wikipedia.

eZ publish Community

The eZ publish community includes anyone and everyone who has used or uses eZ publish. (Partners, Developers, Users, Customers)

International blogging site

The primary source of eZ Publish related blogging can be found at planetezpublish.org

Localized community sites

The following list has to be ordered alphabetically. Keep this in mind when adding items to it.

eZ Components

Sun, 23 Aug 2009 09:39:07 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

For a general description of eZ Components, we recommend, eZ Publish on Wikipedia or eZ Components on eZComponents.org.

About

eZ Publish

eZ Publish 4 adds a new installation requirements including eZ Components which must be installed and available.

Articles

Reviews

References

TCO

Sun, 23 Aug 2009 08:06:14 GMT

For a general description of total cost of ownership, we recommend, Total cost of ownership on Wikipedia.

Custom Tag

Fri, 21 Aug 2009 13:02:44 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

Definition

Custom Tag. A custom defined xml tag.

A custom tag represents custom content not stored directly within the content object itself. This can be almost anything you could imagine which makes the custom tag a very flexible solution to storing links to content not stored within the content object.

Example: Latest news box or remote weather box or simply a template with static html/javascript/css source code like an ads banner javascript/html/css source code from a 3rd party vendor.

Custom tags are created within the eZ Publish system before they are inserted into content object content with the Online Editor.

Usage

Here is a basic example of the key parts of creating a new custom tag.

Examples

The following list has to be ordered alphabetically. Keep this in mind when adding items to it.

Map Address

External resource

Doc: Custom tags documentation
Doc: Old custom tags community documentation
Forum: Custom Tag
Blog: Inclure une vidéo de DailyMotion, Youtube ou autre dans eZ publish

Snippets

Fri, 21 Aug 2009 12:59:47 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

Snippets of eZ Publish related source code

About

A place to document existing references of eZ publish related source code snippets.

While a wiki is not the best place to store and maintain software source code snippets often it is one of the quickest ways to quickly distribute example solution source code snippets.

eZpedia offers the 'snippets' namespace folder a quick place to store snippets of example source code (in just about any language; php, eztpl, ezini, ezphp, sql, javascript, bash, perl, etc).

While this page documents existing snippets of source code from various locations like the forums and eZpedia, there is a new project to collect and refine example snippets of eZ Publish related source code snippets (of any lanugage) at projects.ez.no/ezsnippets

External references

PHP

Those seaking eZ Publish API code samples in PHP would be wise to also study the eZ publish source code and doxygen api documentation.

Forum: Create a binary file within eZ using PHP
Forum: Create a binay image file within eZ using PHP
Forum: Create a folder within eZ using PHP
eZpedia: Snippet: eZ cli data creation script (unstable)
eZpedia: Snippet: eZ cli lorem ipsum data creation script (unstable)
snipplr.com: ez-publish snippets

Javascript

Forum: Javascript click to enlarge image example snippet

Discussions

Fri, 21 Aug 2009 06:04:34 GMT

Discussions about eZ Publish on eZpedia

Note: Take notice to the 'Discussion' links which appear within the 'This article' box on the left side menu only when discussion forums have been created for specific topic discussions.

General discussions can be found in our main discussion forum.

You can always check the latest discussions view for the most recent activity.

Coding standards

Thu, 20 Aug 2009 22:59:04 GMT

What follows is based on certified results and has been tested and proven in practice. Please discuss any corrections and additionally needed information before making changes.

About

About software coding standards

General

Enforcing a software coding convention is a recommended best prance

What convention should I use?

The answer is simple. It's your choice. Your free to choose.

Yet it is strongly recommended that you follow the recommended convention.

If you are creating an ezpublish extension / site use the ezpublish conventions as they are directly applicable.

However if you are creating an ezcomponent itself you will want to use the ezcomponents conventions as they are directly applicable.

eZ Publish

eZ publish has it's own coding standard convention. This convention has evolved over time but the documentation regarding these improved methodologies.

eZ Components

eZ Components also has it's own coding standard convention

External references

FAQ For eZ Publish 3

Wed, 19 Aug 2009 09:49:07 GMT

This page contains answers to some of the most frequently-asked questions from the forum.

Preventing php maximum execution time exceeded errors

If loading a page takes very long and then finally you get an fatal error "Maximum execution time of 30 seconds exceeded". What to do now?

If your looking for solution to preventing php maximum execution time exceeded errors, Increasing the max_execution_time PHP setting will mostly fix this problem. However, sometimes there are other solutions to the maximum execution time exceeded errors. You may also see this forum thread.

How do I remove index.php from URLs?

Have a look at this article.

Improving eZ publish environment and performance

If your having performance problems review this forum discussion.

Improving web server performance

If your looking for the very best eZ Publish web server performance have a look at this article on lighttpd.

Disabling language selection when creating content objects

If your looking for a way to disabling language selection durring the creation of content objects in the admin, forum, etc see this forum thread.

Retrieving all packages for eZ Publish 3.8

If your looking for a way to retrieve all packages for an eZ Publish 3.8 installation, consider upgrading x)

Converting encoding from iso-8859-1 to utf-8

If your looking for a way to convert your encoding from iso-8859-1 to utf-8 have a look at this forum thread.

Importing content into eZ Publish

If your looking for solutions to importing content into eZ Publish have a detailed review of this article on import.

Supporting a payment gateway in eZ publish

If your looking for information on how to support a payment gateway in eZ Publish have a thorough review of this article and it's references.

Comparing eZ publish with other software packages

Have a look at this article with references to several different discussions on this topic.

Variable $node is not provided in pagelayout.tpl

This is just one of several different examples of a rather long story ends with the user creating and populating this variable by custom modification within their own pagelayout.tpl as this variable is no longer provided by the default template variables set by eZ Publish internally.

FAQ

Wed, 19 Aug 2009 07:41:11 GMT

This page contains answers to some of the most frequently-asked questions from the forum.

Preventing php maximum execution time exceeded errors

If loading a page takes very long and then finally you get an fatal error "Maximum execution time of 30 seconds exceeded". What to do now?

How do I remove index.php from URLs?

Have a look at this article.

Improving eZ publish environment and performance

If your having performance problems review this forum discussion.

Improving web server performance

If your looking for the very best eZ Publish web server performance have a look at this article on lighttpd.

Disabling language selection when creating content objects

If your looking for a way to disabling language selection durring the creation of content objects in the admin, forum, etc see this forum thread.

Converting encoding from iso-8859-1 to utf-8

If your looking for a way to convert your encoding from iso-8859-1 to utf-8 have a look at this forum thread.

Importing content into eZ Publish

If your looking for solutions to importing content into eZ Publish have a detailed review of this article on import.

Supporting a payment gateway in eZ publish

If your looking for information on how to support a payment gateway in eZ Publish have a thorough review of this article and it's references.

Comparing eZ publish with other software packages

Have a look at this article with references to several different discussions on this topic.

Variable $node is not provided in pagelayout.tpl

utf8

Tue, 18 Aug 2009 11:52:45 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

For a general description of utf8 we recommend utf8 on Wikipedia.

About

utf8

About

Abstraction

Tue, 18 Aug 2009 11:51:35 GMT

For a general description of abstraction we recommend abstraction on Wikipedia.

How to send email to users

Mon, 17 Aug 2009 15:47:09 GMT

About

Often customers ask to send users to website users.

This can be achieved by one of any number of means.

Question

I need to send an email to all registered members of a customer ecommerce site with existing users, forums and shop orders. How can this be achieved?

Solutions

Take a look at the features offered by the more recently updated phplist extension.

References

https://projects.ez.no/phplist

How to enable large file upload support

Mon, 17 Aug 2009 15:31:07 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

Web applications basically must usually be configured to support large file uploads as well as web servers.

I can't begin to remember to forget the first time I configured eZ Publish v1.x and Apache 1.x to support large file uploads.

Example

Here is an example solution

Steps

It sounds like you want to optimize your web server and php configurations together to avoid this error.

Evaluation: Which version of apache are you running?
1. Apache 1.3.x
- This sounds strikingly similar to an apache 1.3 (large file upload) configuration issue I've learned to avoid over the years. set LimitRequestBody to an int (file size in bytes) value larger than your largest file.
- I found I often needed this apache settings change along with the php settings changes to enable large file uploads with apache 1.3
- Based on the size of the file being uploaded. Consider raising the values of the post_max_size to a larger value than the file being uploaded, as well as the value of max_input_time and max_execution_time beyond the amount of time required to complete the upload of the file.
eZ 4.x, Edit ... to enable large file support withing web application.
1. Example missing. Must not be required (per say)

PHP 5.x, Edit relevant php.ini configuration values

max_execution_time = 45     ; Maximum execution time of each script, in seconds
max_input_time = 60 ; Maximum amount of time each script may spend parsing request data
;max_input_nesting_level = 64 ; Maximum input variable nesting level
memory_limit = 258M      ; Maximum amount of memory a script may consume (128MB)
 
; Maximum size of POST data that PHP will accept.
post_max_size = 201M
 
; Whether to allow HTTP file uploads.
file_uploads = On
 
; Temporary directory for HTTP uploaded files (will use system default if not
; specified).
;upload_tmp_dir =
 
; Maximum allowed size for uploaded files.
upload_max_filesize = 201M

Clear eZ Caches and Restart Apache services

References

Issue tracker

Mon, 17 Aug 2009 09:22:57 GMT

About

eZ Systems currently uses the wIT Issue Tracker to track issues regarding any of their projects. According to Derick Rethans wIT uses Pear's Text_Wiki package. The full spectrum of markup can be found at the Text_Wiki sample page.

Site

https://issues.ez.no

Sitemap

Mon, 17 Aug 2009 04:27:17 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

About sitemaps in eZ Publish

Types

Website Navigation Sitemaps
Search Engine Index Sitemaps

References

Standard: sitemaps.org
Project: GoogleSitemap

Antivirus

Mon, 17 Aug 2009 00:35:36 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

For a general description of antivirus software, we recommend Antivirus software on Wikipedia.

Extensions

eZ Publish 4, Antivirus
eZ Publish 3, Antivirus (ClamAV) integration

Reference

Forum: N/A

View count

Mon, 17 Aug 2009 00:31:14 GMT

About

eZ Publish provides a feature not enabled by default to count page views.

References

Doc: N/A
Forum: N/A

Contributor License Agreement

Mon, 17 Aug 2009 00:26:23 GMT

About

Also known in abbreviated form as C.L.A.

When you contribute source code to eZ you may need to assign some limited rights along as well for the contribution to be accepted by eZ Systems.

References

diff

Sun, 16 Aug 2009 23:18:48 GMT

This feature is available since eZ publish 3.8.

This is a Stub article. Help the eZ Publish community by expanding it!

For a general description of diff, we recommend diff on Wikipedia.

You can make a diff between two content object versions with the content/diff view. This view was added in eZ publish 3.8.
In eZ publish 3.9, the content/diff view is deprecated and a new view content/history is introduced. This new view also replaces the content/versions view.
Patches are comprised of diff results.

External resources

Articles
- New features in eZ publish 3.8: Comparing versions
Documentation: content/history feature doc
Documentation: content/diff feature doc
Specification: Content Version Diff

Templates

Sun, 16 Aug 2009 23:16:16 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

eZ publish uses templates as the basis of website design. Templates represent the display formating, templating and internationalization layer of eZ publish.

Templates plug directly into eZ publish and are programed in eZ Template language (also known as tpl, eztpl). eZ publish templates have been called similar to ... smarty templates (or lisp)?

While simply elegant to use templates are a very powerful tool comprised of even more powerful tools and information. eZ publish templates come with a large number of built in template features. This allows functionality to be implemented very quickly and simply.

While larger templates may benefit in reduced performance load in implementing some functionality as a custom extension.

Subjects

eZ publish 3

Sun, 16 Aug 2009 11:37:35 GMT

About

eZ publish 3 represented a complete re-write when compared to eZ publish 2

Features

eZ publish 3 introduced several core new features

content objects
content module
siteaccess settings
override settings
design extensions

Bash Profile

Sat, 15 Aug 2009 11:29:30 GMT

eZ Publish Community Bash Profile

A simple standardized bash profile addition with useful modifications for use with eZ Publish.

Bash

Example #1, Standardized bash profile

# 2009.07.19 | Initial example idea (very ruff, apologies)
 
# regularly run scripts, cronjobs, and or other commands
alias ezpgenerateautoloads.php = "php ./bin/php/ezpgenerateautoloads.php $1";
alias ga = "php ./bin/php/ezpgenerateautoloads.php $1";
 alias clearcache.sh = "php ./bin/php/ezcache.php $1";
alias clearcache = "php ./bin/php/ezcache.php $1";
alias ezcache = "php ./bin/php/ezcache.php $1";
  alias clr = "php ./bin/php/ezcache.php $1";
 
# commands
alias removesvndirs="find . -name *~ -print0|xargs -0 rm -vrf";
alias cleandirs="find . -name *~ -print0|xargs -0 rm -vrf; find . -name *.svn -print0|xargs -0 rm -vrf; find . -name *.DS* -print0|xargs -0 rm -vrf;"
 
# logs
 alias tailapache = "tail -n 300 /var/log/apache/error_log $1";
 
 alias tailezp = "tail -n 350 ./var/log/error.log & tail -n 350 ./var/log/storage.log & tail -n 350 ./var/log/warning.log & tail -n 350 ./var/log/notice.log &";

Example #1, Standardized bash profile

Tcsh

Example #2, Standardized tcsh profile

# Example

Example #2, Standardized tcsh profile

Reference

Bash
Sh
Tcsh

Zend

Sat, 15 Aug 2009 11:26:52 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

Summary

You can actually use Zend software with eZ Publish.

You can even use Zend Framework PHP with / within eZ Publish compatible PHP

Related extensions

Zend Framework
- ...

Zend Platform
- Download Server Extension
- Zend Cache Extension
Zend Studio/Neon
- Coding Standard Profile
- Template code for Zend Studio

References

Database

Sat, 15 Aug 2009 11:07:21 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

Supported

The following relational database management systems can be used by eZ publish out of the box.

Additional

Additional eZ Publish extensions exist which provide support for the following relational database management systems.

Resources

Article: Database Usage
Forum: How can I find the table in the database?
Forum: Datamodel documentation

Search

Sat, 15 Aug 2009 10:58:28 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

Everything you ever wanted to know about eZ publish search features and beyond ...

The search view and the advanced search view provide interfaces to the search features of eZ publish.

Standard

eZ publish as an advanced and extensible php based search solution.

Content

Advanced content class attribute level search index control

Binary

eZ publish can also index content from binary files

External

Search Plugins
Search Engines

Troubleshooting

Searching on specific words doesn't return any results, while you're sure there are content fields containing the word

Check if the fields containing the words are search-enabled.
Check to ensure content has been completely indexed properly. This requires you run the index cronjob part.
Maybe the words are recognized as stop words and filtered out. Check the settings StopWordTresholdPercent and StopWordTresholdValue and tweak them appropriately. (1)

External resources

Contributions

References

None

Advanced search

Sat, 15 Aug 2009 10:54:43 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

eZ publish provides an advanced search module view which can be customized in many flexible ways.

The advance search module path is '/content/advancedsearch'. To use this module build an HTML form with pre-defined POST variables.

List of POST variables accepted:

"SearchText" - usually a text input field to allow to enter the search terms.
"PhraseSearchText" - usually a text input field that matches an exact search phrase.
"SearchContentClassID" - Limit the search result to specific content classes. Use "-1" for all content classes. Sometimes a drop down option list.
"SearchContentClassAttributeID" - Limit the search result to specific content class attributes.
"SearchDate" - Limit the search results to after specified date. Use "-1" for date.
"SearchTimestamp" - Limit the search results to after specified timestamp.
"SearchSectionID" - Limit the search results to a specific section. Use "-1" for all sections.
"SubTreeArray" - Limit the search results to specific array of subtrees.
"SearchPageLimit" - Limit the search results displayed by convention. Often a hidden variable. Here is an example of the convention.

function pageLimit( $searchPageLimit )
{
    switch ( $searchPageLimit )
    {
        case 1:
            return 5;
 
        case 2:
        default:
            return 10;
 
        case 3:
            return 20;
 
        case 4:
            return 30;
 
        case 5:
            return 50;
    }
}
 
</pre>

There are more POST variables that the advanced search understands. Review the search module view for additional variables.

Reference

Doc: N/A
Source: kernel/content/advancedsearch.php

OpenDocument

Mon, 10 Aug 2009 01:09:44 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

For a general description of OpenDocument, we recommend OpenDocument on Wikipedia.

Extension

Solutions

External resources

Project: ezodf
SVN: ezodf

Website Interface releases

Sun, 09 Aug 2009 21:58:30 GMT

Release	eZ Publish version
1.3-1	4.0.1
1.3-0	4.0.0
1.2-1	3.9.4, 3.10.0
1.2-0	3.9.2
1.1-1	3.9.0

API BC Breaks

Sun, 09 Aug 2009 21:57:38 GMT

eZ Publish 4

4.1

4.1.0

eZContentObject::fetchAttributesByIdentifier() doesn't accept any longer a string as 3rd argument, it needs to be an array now. See issue #13668.

4.0

4.0.1

The constructor of eZSOAPClient has a new parameter $useSSL, which defines the protocol to use: either https:// when $useSSL is false (default) or https:// when $useSSL is true. Previously, when the $port argument was 443, it was assumed automatically that https:// should be used. This is not longer the case in eZ Publish 4.0.1. In eZ Publish 4.0.2 however, this BC break will be fixed. For more background information, see issue #12267.

4.0.0

eZContentObjectTreeNode::subTree() and eZContentObjectTreeNode::subTreeCount() can not any longer be called statically, they are instance methods now. Use eZContentObjectTreeNode::subTreeByNodeID() and eZContentObjectTreeNode::subTreeCountByNodeID() instead.
eZContentObjectTreeNode::createPathConditionAndNotEqParentSQLStrings() does not have a 3rd argument $treeNode anymore. Use the 4th argument $nodeID instead to pass the ID of the tree node.
To register workflow event types, use eZWorkflowEventType::registerEventType() instead of eZWorkflowEventType::registerType().

Shipping handler

Sun, 09 Aug 2009 21:52:48 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

eZ Publish provides a system to handle ecommerce shipping cost calculation

External references

Doc: Improved shipping handling
Contrib: Sample shipping handler
Forum: Shipping in EZP 3.8+
Forum: Some advice please: billing + shipping address
Forum: On-line Shop - Shipping per country and Payment Options
Forum Search: Shipping
Extension source: ezsampleshipping SVN
Extension source: shipping community SVN
Extension projects.ez.no: Countryshipping
Extension projects.ez.no: BC Static Shipping
Extension projects.ez.no: Automated Shipping with API Integration UPS, USPS. xrow E-Commerce Complete
Category at projects.ez.no: https://projects.ez.no/types/ez_publish/shipping_handler

Shop account handler

Sun, 09 Aug 2009 21:50:49 GMT

About

shopaccounthandler provides for the customization of the registration process

Explanation

It's the component you can create inside an extension to alter the registration process.

Examples

Settings

File, example_com/settings/shopaccount.ini.append

#?ini charset="utf-8"?
[HandlerSettings]
ExtensionRepositories[]=example_com
 
 
[AccountSettings]
Handler=ezcustomized

Handler

File, example_com/shopaccounthandlers/ezcustomizedshopaccounthandler.php

<?php
 
include_once( 'lib/ezxml/classes/ezxml.php' );
 
class eZCustomizedShopAccountHandler
{
    /*!
    */
    function eZCustomizedShopAccountHandler()
    {
 
    }
 
    /*!
     Will verify that the user has supplied the correct user information.
     Returns true if we have all the information needed about the user.
    */
    function verifyAccountInformation()
    {
        return false;
    }
 
    /*!
     Redirectes to the user registration page.
    */
    function fetchAccountInformation( &$module )
    {
        $module->redirectTo( '/shop/userregister/' );
    }
 
    /*!
     \return the account information for the given order
    */
    function email( $order )
    {
        $xml = new eZXML();
        $xmlDoc =& $order->attribute( 'data_text_1' );
        if( $xmlDoc != null )
        {
            $dom =& $xml->domTree( $xmlDoc );
            $email =& $dom->elementsByName( "email" );
            return $email[0]->textContent();
        }
        else
            return false;
    }
 
    /*!
     \return the account information for the given order
    */
    function accountName( $order )
    {
        $accountName = "";
        $xml = new eZXML();
        $xmlDoc =& $order->attribute( 'data_text_1' );
        if( $xmlDoc != null )
        {
            $dom =& $xml->domTree( $xmlDoc );
            $firstName = $dom->elementsByName( "first-name" );
            $mi = $dom->elementsByName( "mi" );
 
            if( isset($mi[0]) ){
                $mi_tc = $mi[0]->textContent();
            }else{
                $mi_tc = '';
            }
 
            $lastName = $dom->elementsByName( "last-name" );
            $accountName = $firstName[0]->textContent() . " " . $mi_tc ." " . $lastName[0]->textContent();
        }
 
        return $accountName;
    }
 
    function accountInformation( $order )
    {
        $xml = new eZXML();
        $xmlDoc =& $order->attribute( 'data_text_1' );
        $dom =& $xml->domTree( $xmlDoc );
 
        $firstName =& $dom->elementsByName( "first-name" );
        $mi =& $dom->elementsByName( "mi" );
        $lastName =& $dom->elementsByName( "last-name" );
 
        $address1 =& $dom->elementsByName( "address1" );
        $address2 =& $dom->elementsByName( "address2" );
 
        $city =& $dom->elementsByName( "city" );
        $state =& $dom->elementsByName( "state" );
        $zip =& $dom->elementsByName( "zip" );
 
        $phone =& $dom->elementsByName( "phone" );
        $email =& $dom->elementsByName( "email" );
 
        $shipping =& $dom->elementsByName( "shipping" );
        $shippingtype =& $dom->elementsByName( "shippingtype" );
 
        $s_firstName =& $dom->elementsByName( "s_first-name" );
        $s_mi =& $dom->elementsByName( "s_mi" );
        $s_lastName =& $dom->elementsByName( "s_last-name" );
 
        $s_address1 =& $dom->elementsByName( "s_address1" );
        $s_address2 =& $dom->elementsByName( "s_address2" );
 
        $s_city =& $dom->elementsByName( "s_city" );
        $s_state =& $dom->elementsByName( "s_state" );
        $s_zip =& $dom->elementsByName( "s_zip" );
 
        $s_phone =& $dom->elementsByName( "s_phone" );
        $s_email =& $dom->elementsByName( "s_email" );
 
        // $country =& $dom->elementsByName( "country" );
        // $comment =& $dom->elementsByName( "comment" );
 
        $firstNameText = "";
        if ( is_object( $firstName[0] ) )
            $firstNameText = $firstName[0]->textContent();
 
        $miText = "";
        if( isset( $mi[0] ) )
        {
        if ( is_object( $mi[0] ) )
            $miText = $mi[0]->textContent();
        }
 
        $lastNameText = "";
        if ( is_object( $lastName[0] ) )
            $lastNameText = $lastName[0]->textContent();
 
        $address1Text = "";
        if ( is_object( $address1[0] ) )
            $address1Text = $address1[0]->textContent();
 
        $address2Text = "";
        if ( is_object( $address2[0] ) )
            $address2Text = $address2[0]->textContent();
 
        $cityText = "";
        if ( is_object( $city[0] ) )
            $cityText = $city[0]->textContent();
 
        $stateText = "";
        if ( is_object( $state[0] ) )
            $stateText = $state[0]->textContent();
 
        $zipText = "";
        if ( is_object( $zip[0] ) )
            $zipText = $zip[0]->textContent();
 
        $phoneText = "";
        if ( is_object( $phone[0] ) )
            $phoneText = $phone[0]->textContent();
 
        $emailText = "";
        if ( is_object( $email[0] ) )
            $emailText = $email[0]->textContent();
 
        $shippingText = "";
        if ( is_object( $shipping[0] ) )
            $shippingText = $shipping[0]->textContent();
 
        $shippingTypeText = "";
        if ( is_object( $shippingtype[0] ) )
            $shippingTypeText = $shippingtype[0]->textContent();
 
        // ezDebug::writeDebug( count($s_firstName), 'eZUser Information'  );
 
        $s_firstNameText = "";
        if ( count($s_firstName) > 0 and is_object( $s_firstName[0] ) )
            $s_firstNameText = $s_firstName[0]->textContent();
 
        $s_miText = "";
        if ( count($s_firstName) > 0 and is_object( $s_mi[0] ) )
            $s_miText = $s_mi[0]->textContent();
 
        $s_lastNameText = "";
        if ( count($s_firstName) > 0 and is_object( $s_lastName[0] ) )
            $s_lastNameText = $s_lastName[0]->textContent();
 
        $s_address1Text = "";
        if ( count($s_firstName) > 0 and is_object( $s_address1[0] ) )
            $s_address1Text = $s_address1[0]->textContent();
 
        $s_address2Text = "";
        if ( count($s_firstName) > 0 and is_object( $s_address2[0] ) )
            $s_address2Text = $s_address2[0]->textContent();
 
        $s_cityText = "";
        if ( count($s_firstName) > 0 and is_object( $s_city[0] ) )
            $s_cityText = $s_city[0]->textContent();
 
        $s_stateText = "";
        if ( count($s_firstName) > 0 and is_object( $s_state[0] ) )
            $s_stateText = $s_state[0]->textContent();
 
        $s_zipText = "";
        if ( count($s_firstName) > 0 and is_object( $s_zip[0] ) )
            $s_zipText = $s_zip[0]->textContent();
 
        $s_phoneText = "";
        if ( count($s_firstName) > 0 and is_object( $s_phone[0] ) )
            $s_phoneText = $s_phone[0]->textContent();
 
        $s_emailText = "";
        if ( count($s_firstName) > 0 and is_object( $s_email[0] ) )
            $s_emailText = $s_email[0]->textContent();
 
        return array( 'first_name' => $firstNameText,
                      'mi' => $miText,
                      'last_name' => $lastNameText,
                      'address1' => $address1Text,
                      'address2' => $address2Text,
                      'city' => $cityText,
                      'state' => $stateText,
                      'zip' => $zipText,
                      'phone' => $phoneText,
                      'email' => $emailText,
                      'shipping' => $shippingText,
                      'shippingtype' => $shippingTypeText,
                      's_first_name' => $s_firstNameText,
                      's_mi' => $s_miText,
                      's_last_name' => $s_lastNameText,
                      's_address1' => $s_address1Text,
                      's_address2' => $s_address2Text,
                      's_city' => $s_cityText,
                      's_state' => $s_stateText,
                      's_zip' => $s_zipText,
                      's_phone' => $s_phoneText,
                      's_email' => $s_emailText );
    }
}
 
?>

Templates

Html Template

File, example_com/design/standard/templates/shop/accounthandlers/html/ez.tpl

{* DO NOT EDIT THIS FILE! Use an override template instead. *}
 <table width="100%" cellspacing="0" cellpadding="0" border="0">
 <tr>
 <td valign="top">
         <b>{"Customer"|i18n("design/standard/shop")}</b>
         </p>
         <p>
         {'Name'|i18n('design/standard/shop')}: {$order.account_information.first_name} {$order.account_information.last_name}<br />
         {'Email'|i18n('design/standard/shop')}: {$order.account_information.email}<br />
 </td>
 <td valign="top" width="300px;">
 {if eq($order.account_information.shipping,1)}
 <b>{"Address"|i18n("design/standard/shop")}</b>
 <table border="0"  cellspacing="0" cellpadding="0">
 <tr><td>{'Address'|i18n('design/standard/shop')}:</td><td>{$order.account_information.address1}</td></tr>
 {if gt(count($order.account_information.address2),0)}
 <tr><td> </td><td>{$order.account_information.address2}</td></tr>
 {/if}
 <tr><td>{'City'|i18n('design/standard/shop')}:</td><td>{$order.account_information.city}</td></tr>
 <tr><td>{'State'|i18n('design/standard/shop')}:</td><td>{$order.account_information.state}</td></tr>
 <tr><td>{'Zip code'|i18n('design/standard/shop')}:</td><td>{$order.account_information.zip}</td></tr>
 <tr><td>{'Phone'|i18n('design/standard/shop')}:</td><td>{$order.account_information.phone}</td></tr>
 <tr><td>{'Shipping'|i18n('design/standard/shop')}:</td><td>
 {switch match=$order.account_information.shippingtype}
 {case match="1"}
     Next Day Service
 {/case}
 {case match="2"}
     2nd Day Service
 {/case}
 {case}
     Standard Shipping
 {/case}
 {/switch}
 </td></tr>
 </table>
 
 {else}
 
 <b>{"Billingaddress"|i18n("design/standard/shop")}</b>
 <table border="0"  cellspacing="0" cellpadding="0">
 <tr><td>{'Address'|i18n('design/standard/shop')}:</td><td>{$order.account_information.address1}</td></tr>
 {if gt(count($order.account_information.address2),0)}
 <tr><td> </td><td>{$order.account_information.address2}</td></tr>
 {/if}
 <tr><td>{'City'|i18n('design/standard/shop')}:</td><td>{$order.account_information.city}</td></tr>
 <tr><td>{'State'|i18n('design/standard/shop')}:</td><td>{$order.account_information.state}</td></tr>
 <tr><td>{'Zip code'|i18n('design/standard/shop')}:</td><td>{$order.account_information.zip}</td></tr>
 <tr><td>{'Phone'|i18n('design/standard/shop')}:</td><td>{$order.account_information.phone}</td></tr>
 <tr><td>{'Shipping'|i18n('design/standard/shop')}:</td><td>
 {switch match=$order.account_information.shippingtype}
 {case match="1"}
     Next Day Service
 {/case}
 {case match="2"}
     2nd Day Service
 {/case}
 {case}
     Standard Shipping
 {/case}
 {/switch}
 
 </td></tr>
 </table>
 <br />
 <b>{"Shippingaddress"|i18n("design/standard/shop")}</b>
 <table border="0"  cellspacing="0" cellpadding="0">
 <tr><td>Name:</td><td>{$order.account_information.s_first_name} {$order.account_information.s_last_name}</td></tr>
 <tr><td>MI:</td><td>{$order.account_information.s_mi}</td></tr>
 <tr><td>{'Address'|i18n('design/standard/shop')}:</td><td>{$order.account_information.s_address1}</td></tr>
 {if gt(count($order.account_information.s_address2),0)}
 <tr><td> </td><td>{$order.account_information.s_address2}</td></tr>
 {/if}
 <tr><td>{'City'|i18n('design/standard/shop')}:</td><td>{$order.account_information.s_city}</td></tr>
 <tr><td>{'State'|i18n('design/standard/shop')}:</td><td>{$order.account_information.s_state}</td></tr>
 <tr><td>{'Zip code'|i18n('design/standard/shop')}:</td><td>{$order.account_information.s_zip}</td></tr>
 <tr><td>{'Phone'|i18n('design/standard/shop')}:</td><td>{$order.account_information.s_phone}</td></tr>
 <tr><td>{'Email'|i18n('design/standard/shop')}:</td><td>{$order.account_information.s_email}</td></tr>
 </table>
 
 
 {/if}
 </td>
 </tr>
 </table>

Text Template

File, example_com/design/standard/templates/shop/accounthandlers/ascii/ez.tpl

Name: {$order.account_information.first_name} {$order.account_information.last_name}
Email: {$order.account_information.email}
MI: {$order.account_information.mi}
 
Address1: {$order.account_information.address1}
 
{if gt(count($order.account_information.address2),0)}
Address2: {$order.account_information.address2}
{/if}
 
City: {$order.account_information.city}
State: {$order.account_information.state}
Zip code: {$order.account_information.zip}
Phone: {$order.account_information.phone}
Shipping: {switch match=$order.account_information.shippingtype}{case match="1"}Next Day Service{/case}{case match="2"}2nd Day Service{/case}{case}Standard Shipping{/case}{/switch}
 
 
{if eq($order.account_information.shipping,0)}
Shipped to:
 
Name: {$order.account_information.s_first_name} {$order.account_information.s_last_name}
MI: {$order.account_information.s_mi}
Address1: {$order.account_information.s_address1}
 
{if gt(count($order.account_information.s_address2),0)}
Address2: {$order.account_information.s_address2}
{/if}
 
City: {$order.account_information.s_city}
State': {$order.account_information.s_state}
Zip code: {$order.account_information.s_zip}
Phone: {$order.account_information.s_phone}
Email: {$order.account_information.s_email}

Html Admin Template

File, example_com/design/admin/templates/shop/accounthandlers/html/ez.tpl

{* Name. *}
<div class="block">
<label>{'Name'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}:</label>
{let customer_user=fetch( content, object, hash( object_id, $order.user_id ) )}
<a href={$customer_user.main_node.url_alias|ezurl}>{$order.account_information.first_name} {$order.account_information.last_name}</a>
{/let}
</div>
 
{* Email. *}
<div class="block">
<label>{'E-mail'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}:</label>
<a href="mailto:{$order.account_information.email}">{$order.account_information.email}</a>
</div>
 
{* Address. *}
<div class="block">
 
<fieldset>
<legend>{'Address'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</legend>
{if ne($order.account_information.shipping,1)}
<table class="list" cellspacing="0">
<tr>
<td><b>Billingaddress</b></td>
<td><b>Shippingaddress</b></td>
</tr>
<tr>
<td>
{/if}
<table class="list" cellspacing="0">
<tr>
    <td>{'First Name'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>{$order.account_information.first_name}</td>
</tr>
<tr>
    <td>MI</td>
    <td>{$order.account_information.mi}</td>
</tr>
<tr>
    <td>{'Last Name'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>{$order.account_information.last_name}</td>
</tr>
<tr>
    <td>{'Address 1'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>{$order.account_information.address1}</td>
</tr>
<tr>
    <td>{'Address 2'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>{$order.account_information.address2}</td>
</tr>
<tr>
    <td>{'City'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>{$order.account_information.city}</td>
</tr>
<tr>
    <td>{'State'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>{$order.account_information.state}</td>
</tr>
<tr>
    <td>{'Zip Code'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>{$order.account_information.zip}</td>
</tr>
<tr>
    <td>{'Phone'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>{$order.account_information.phone}</td>
</tr>
<tr>
    <td>{'Shipping Type'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>
        {if eq($order.account_information.shippingtype,1)}
            Next Day Service
        {elseif eq($order.account_information.shippingtype,2)}
            2nd Day Service
        {else}Standard Shipping
        {/if}
    </td>
</tr>
</table>
 
{if ne($order.account_information.shipping,1)}
</td>
<td>
<table class="list" cellspacing="0">
<tr>
    <td>{'First Name'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>{$order.account_information.s_first_name}</td>
</tr>
<tr>
    <td>MI</td>
    <td>{$order.account_information.s_mi}</td>
</tr>
<tr>
    <td>{'Last Name'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>{$order.account_information.s_last_name}</td>
</tr>
<tr>
    <td>{'Address 1'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>{$order.account_information.s_address1}</td>
</tr>
<tr>
    <td>{'Address 2'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>{$order.account_information.s_address2}</td>
</tr>
<tr>
    <td>{'City'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>{$order.account_information.s_city}</td>
</tr>
<tr>
    <td>{'State'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>{$order.account_information.s_state}</td>
</tr>
<tr>
    <td>{'Zip Code'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>{$order.account_information.s_zip}</td>
</tr>
<tr>
    <td>{'Phone'|i18n( 'design/admin/shop/accounthandlers/html/ez' )}</td>
    <td>{$order.account_information.s_phone}</td>
</tr>
<tr>
    <td>Email</td>
    <td>{$order.account_information.s_email}</td>
</tr>
</table>
</td>
</tr>
</table>
{/if}
</fieldset>
 
</div>

External reference

Image alias handler

Sun, 09 Aug 2009 21:47:57 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

Introduction

This eZ Publish kernel class provides for the simple PHP based interphase to fetch an original image alias and image alias properties (uri, width, height, etc).

Detailed examples of the methods provided by this class are available within the API documentation.

Brief examples of how to use the class methods are provided in the following solution reference documentation.

Details

Internal manager for the eZImage datatype.

Takes care of image conversion and serialization from and to the internal XML format.

Note:This handler was introduced in eZ Publish 3.3 and will detect older eZImage structures and convert them on the fly.

The XML storage was improved in 3.8, from then it always stores the attribute ID, version and language in the <original> tag. This was required to get the new multi-language features to work.

References

Doc: Kernel Class API, eZImageAliasHandler
Solution: Fetching ezimage datatype image alias properties using PHP
Forum: New image system
Doc: Reference: ezimagealiashandler
Forum: Import image into existing class
Forum: displaying custom class images ezimagealiashandler

Migrating

Sun, 09 Aug 2009 21:41:46 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

Reference

Setting: ShowXHTMLCode

Sun, 09 Aug 2009 21:39:06 GMT

The ShowXHTMLCode setting in site.ini, [TemplateSettings] will put extra paragraphs in your template output, showing where the parsed output of certain templates starts and stops.

To use ShowXHTMLCode, you need to enable Debug too.

You should disable ShowXHTMLCode on production sites. When you're using the notification system or information collector mails, these extra paragraphs will be put in your mail too, also when the mails are in plain text.

Quick settings toolbar

You can switch ShowXHTMLCode on and off with the "Inline template debug" checkbox of the quick settings toolbar in the admin interface.

External resources

ShowXHTMLCode in the reference_documentation

Setting: PHPOperatorList

Sun, 09 Aug 2009 21:37:29 GMT

About

eZ publish has the ability built-in to eZ publish to support the use of php functions directly in template code as template operators with a configuration settings addition of the php function name.

Limitation

Only supports functions which accept only a single parameter.

Alternatives

You can use more features of php without limitations by using the wrap_operator extension instead.

Functions

A brief list of know functions which accept only a single parameter.

The following list has to be ordered alphabetically. Keep this in mind when adding items to it.

Example

Example, 'settings/override/template.ini.append.php'

[PHP]
# A list with php functions and their equivelant template operator names
# Giving the operators a different name from the PHP functions
# are recommended, that way you ensure that all operators follow
# the same naming guidelines. It also means that you can change the
# php function later on without doing template changes.
PHPOperatorList[]
PHPOperatorList[urlencode]=urlencode

External reference

Documentation: Custom template operators (3.4)
Documentation: Template operator (3.4)
Documentation: Including php files in templates (3.4)
Forum: How to convert date in timestamp

Syntax highlighting

Sun, 09 Aug 2009 21:33:09 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

For a general description of syntax highlighting, we recommend Syntax highlighting on Wikipedia.

About

When developing with eZ a strict adherence to best practices, standards and guidelines is greatly encouraged. A good start to following these are to enable syntax highlighting support for your favorite editor of choice.

Support for ez template language in 3rd party editors

The following list has to be ordered alphabetically. Keep this in mind when adding items to it.

Extensions related to syntax highlighting in eZ publish

ezgeshi
ezsh

Feeds

Sun, 09 Aug 2009 21:22:13 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

Syndicated feeds of content about eZ Publish [1]

Members of the community maintain these resources.

Reference

[1] Article: eZ Ecosystem OPML of Feeds

Forum

Sun, 09 Aug 2009 13:26:19 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

For a general description of forum, we recommend Internet Forum on Wikipedia.

eZ publish forum functionality

None ... yet.

Integration with other forum software

eZFluxBB : connective eZ Publish / FluxBB

External resources

Online Editor for forum reply/topic

Postgresql

Sun, 09 Aug 2009 13:09:21 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

eZ Publish support Postgresql

Known Issues

References

MySQL

Sun, 09 Aug 2009 13:07:03 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

External resources

Limit

Sun, 09 Aug 2009 13:05:12 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

What are the limits of eZ Publish?

Questions

What is the limit when using eZ publish?
How many objects can the database hold?

External resources

Forum: eZ with big web site

Hosting

Sun, 09 Aug 2009 13:00:51 GMT

For more information on Hosting, we recommend Hosting on Wikipedia

Brief

eZ Publish is a unique LAMP application (Linux, Apache, MySQL and PHP) which itself has it's own web server requirements which are often not provided for by all LAMP distributions. Be certain before purchasing hosting that your web hosting service provider provides for all of eZ Publish's hosting requirements.

Shared Hosting

eZ Publish requires more resources and services for normal use and operation than most shared hosting providers offer. The use of eZ Publish on shared hosting is strongly discouraged.

eZ Publish requires php safe mode be disabled. Note: In PHP6 safe mode has been removed.

External references

PHPDoc

Sun, 09 Aug 2009 12:46:11 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

In the future eZ Publish will switch to using PHPDoc *

Description

Examples

References

Doc: N/A
Forum: N/A
Project: phpDocumentor: The complete documentation solution for PHP

Doxygen

Sun, 09 Aug 2009 12:42:47 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

For a more general description of Doxygen, we recommend Doxygen on Wikipedia.

About

eZ Publish currently uses the doxygen format inline source code documentation. It is expected that they will switch entirely to PHPDoc in the future.

Solution: Solution: 5 Minute Guide to Doxygen
Solution: Using eZ publish doxygen api documentation
Solution: Creating eZ publish doxygen api documentation

Format

There is a long list of special commands which can be used within your source code.

There exists a pdf manual available for download.

External resources

Issues: Related to doxygen
Project: Doxygen
Doxygen Manual
Download Doxygen Software
PHPDoc

Sun, 09 Aug 2009 12:34:39 GMT

For a general description of newsletter, we recommend Newsletter on Wikipedia.

Extensions implementing a newsletter system

Character encoding

Sun, 09 Aug 2009 12:09:37 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

For a general description of character encoding, we refer to Character encoding on Wikipedia.

Solutions

Template encoding

When creating templates that are intended to use UTF8 encoding, you must add the following:

{*?template charset=utf8?*}

at the top of each template.

Settings encoding

When creating settings files that are intended to use UTF8 encoding, you must add the following:

/*?ini charset=utf8?*/

at the top of each settings file.

References

Unpublishing

Sun, 09 Aug 2009 11:34:34 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

About unpublishing content

Summary

Unpublishing one or multiple content objects can be done in several ways.

delete them
- at a specified date & time, with the unpublish cronjob
hide them
- at a specified date & time, with the hide cronjob
move them to an archive section of your website
- at a specified date & time, with the archive extension

SSL

Sun, 09 Aug 2009 11:30:35 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

Configuring eZ Publish SSL Zones

Description

This is one feature which has not been documented as clearly as other features with the ez.no/doc documentation.

Settings

Settings configuration examples from SSLZoneSettings

References

Article: Applying SSL Zones / New Features in eZ publish 3.8
Forum: Problem to configure zone ssl access / Problem to configure ...
Forum: Detect if url has https
Doc: [SSLZoneSettings] / site.ini / Configuration files / Reference ...
Development Specification: SSL Zones
Development Feature Documentation: SSL Zones
Class: eZSSLZone Class Reference

node

Sun, 09 Aug 2009 10:08:22 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

eZ Publish Content Tree Node

Examples

Detecting locations of a node ...

PHP node object

The php object that represents has a couple attributes that can be accessed (similar to object properties).

List of attributes

"node_id" => array( 'name' => "NodeID",
'datatype' => 'integer',
'default' => 0,
'required' => true ),
"parent_node_id" => array( 'name' => "ParentNodeID",
'datatype' => 'integer',
'default' => 0,
'required' => true,
'foreign_class' => 'eZContentObjectTreeNode',
'foreign_attribute' => 'node_id',
'multiplicity' => '1..*' ),
"main_node_id" => array( 'name' => "MainNodeID",
'datatype' => 'integer',
'default' => 0,
'required' => true,
'foreign_class' => 'eZContentObjectTreeNode',
'foreign_attribute' => 'node_id',
'multiplicity' => '1..*' ),
"contentobject_id" => array( 'name' => "ContentObjectID",
'datatype' => 'integer',
'default' => 0,
'required' => true,
'foreign_class' => 'eZContentObject',
'foreign_attribute' => 'id',
'multiplicity' => '1..*' ),
'contentobject_version' => array( 'name' => 'ContentObjectVersion',
'datatype' => 'integer',
'default' => 0,
'required' => true ),
'contentobject_is_published' => array( 'name' => 'ContentObjectIsPublished',
'datatype' => 'integer',
'default' => 0,
'required' => true ),
"depth" => array( 'name' => "Depth",
'datatype' => 'integer',
'default' => 0,
'required' => true ),
'sort_field' => array( 'name' => 'SortField',
'datatype' => 'integer',
'default' => 1,
'required' => true ),
'sort_order' => array( 'name' => 'SortOrder',
'datatype' => 'integer',
'default' => 1,
'required' => true ),
'priority' => array( 'name' => 'Priority',
'datatype' => 'integer',
'default' => 0,
'required' => true ),
'modified_subnode' => array( 'name' => 'ModifiedSubNode',
'datatype' => 'integer',
'default' => 0,
'required' => true ),
"path_string" => array( 'name' => "PathString",
'datatype' => 'string',
'default' => '',
'required' => true ),
"path_identification_string" => array( 'name' => "PathIdentificationString",
'datatype' => 'text',
'default' => '',
'required' => true ),
'remote_id' => array( 'name' => 'RemoteID',
'datatype' => 'string',
'default' => '',
'required' => true ),
"is_hidden" => array( 'name' => "IsHidden",
'datatype' => 'integer',
'default' => 0,
'required' => true ),
"is_invisible" => array( 'name' => "IsInvisible",
'datatype' => 'integer',
'default' => 0,
'required' => true ) ),

List of object functions to get related values

"name" => "getName",
'data_map' => 'dataMap',
'remote_id' => 'remoteID', // Note: This overrides remote_id field
"object" => "object",
"subtree" => "subTree",
"children" => "children",
"children_count" => "childrenCount",
'view_count' => 'viewCount',
'contentobject_version_object' => 'contentObjectVersionObject',
'sort_array' => 'sortArray',
'can_read' => 'canRead',
'can_pdf' => 'canPdf',
'can_create' => 'canCreate',
'can_edit' => 'canEdit',
'can_hide' => 'canHide',
'can_remove' => 'canRemove',
'can_move' => 'canMoveFrom',
'can_move_from' => 'canMoveFrom',
'can_add_location' => 'canAddLocation',
'can_remove_location' => 'canRemoveLocation',
'can_view_embed' => 'canViewEmbed',
'is_main' => 'isMain',
'creator' => 'creator',
"path" => "fetchPath",
'path_array' => 'pathArray',
"parent" => "fetchParent",
'url' => 'url',
'url_alias' => 'urlAlias',
'class_identifier' => 'classIdentifier',
'class_name' => 'className',
'hidden_invisible_string' => 'hiddenInvisibleString',
'hidden_status_string' => 'hiddenStatusString',
'classes_js_array' => 'availableClassesJsArray' )

Kernel Hack

Sun, 09 Aug 2009 10:05:06 GMT

Question

You might have heard the term hack or kernel hack used by other users of eZ Publish. Well what is a kernel hack in eZ Publish?

Description

An eZ Publish 'Hack' or 'Kernel Hack' is considered any modification to any files or directories outside of the following directories.

settings/override/
settings/siteaccess/
extension/
var/ *

Meaning and meant as a general rule as long as you keep your modification to eZ Publish within the above directories; Inside these directories is acceptable and not a hack. Anything within the 'extension' directory is considered an extension, separate and not a hack; even if you don't activate it or use it like a traditional extension.

* Note: 'var/', modifications are allowed and often required. eZ Publish Packages relies on storing package contents within the var/ directory. For example, eZ Publish Site Design Packages, relies storing package contents like css in the var/ directory for design modifications.

Example Directories

bin
cronjobs
design
doc
kernel
lib
packages
share
support
update

Exceptions

I'm sure there are extensions to these general rules and guidelines. This document is a guide not an absolute.

Patch extensions

Extensions which contain kernel patches where required to impliment a feature that must be added to the kernel. This is rare that most people need to do this but it is known to exist.

References

Kernel Hacking

Kernel Hacking

Sun, 09 Aug 2009 10:04:00 GMT

About

What is a kernel hack

Warning

A word about the implications, warnings and dangers regarding kernel hacking

Support

Kernel hacking in general is a supportable activity not supported by eZ Systems

Repeatability

Your kernel hacking should be repeatable and reliable as much as possible.

Override

As of eZ publish 4.0 you can create kernel override extention with which to override parts of the default kernel of an installation.

Patching

It helps when creating a patch to be familiar with the diff program.

Hacks

List of existing documented kernel hacks.

Kernel

Sun, 09 Aug 2009 09:55:04 GMT

What follows is based on certified results and has been tested and proven in practice. Please discuss any corrections and additionally needed information before making changes.

About

The eZ Publish Kernel

Kernel modifications or overrides :: A warning

At times one needs to use intimidate knowledge of eZ publish internals (kernel) to archive certain specific functionality. It is generally _not_ recommended to change the kernel or stock eZ publish core, because upgrades will be much harder. Patches mean merges often by hand, which can become time consuming and or tedious.

If you really want to do it, learn more about the design of eZ publish, kernel limitations and solutions. Custom solutions based on eZ publish may find that kernel modifications are required to provide extended features or functionality. eZ Publish 4.0 provides the ability to cleanly override files in the kernel within a separate extension.

Note: A word about the implications, dangers and warnings regarding kernel hacking

Remoting

Sun, 09 Aug 2009 09:47:22 GMT

About

Macromedia Flash provides for connection between your Flash appliciations and your web application server for use in creating Rich Internet Applications. With it's simple yet powerfull programming model you can easily integrate rich flash content with eZ Publish. If one needed to provide a rich flash based front end to eZ Publish one could use these to create support needed.

There are several methods which can be used to provide remoting.

Methods

XML
JSON
AMF (Action Message Format)

References

Forum: Macromedia Flash + Ezpublish :: expanding possibilities
Forum: Extension with Zend AMF Server

JSON

Sun, 09 Aug 2009 09:45:18 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

About JSON

Extensions

Reference

Performance

Sun, 09 Aug 2009 09:31:37 GMT

For a general description of performance, we recommend performance tuning on Wikipedia.

Solutions

Improving eZ publish Performance Optimization
PHP Accelerators
Replacing apache with lightpd

External resources

Articles
- eZ publish: Performance Best Practices
- Server Architecture for eZ publish Hosting
Forum topics
- eZ publish performance optimisation FAQ
- Improving eZ publish environment and performance

Headers

Sun, 09 Aug 2009 09:26:40 GMT

Custom HTTP headers

This feature is available since eZ publish 3.8.

About

You can customize the headers based on the requested content subtree or module/view.

External resources

Translation cache

Sun, 09 Aug 2009 08:16:50 GMT

This is a Stub article. Help the eZ Publish community by expanding it!

About

About translation cache in eZ Publish

External resources

Internal caches in the article eZ publish performance and optimization Part 3 of 3: Practical Cache and Template Solutions

Virtualization

Sun, 09 Aug 2009 08:15:49 GMT

For more information on Virtualization, we recommend Virtualization on Wikipedia

This is a Stub article. Help the eZ Publish community by expanding it!

About

A number of hosting providers are providing eZ publish hosting in new ways ...

Products

Vmware
Xen
OpenVZ