eZpedia : eZ

Main page

Mon, 12 Jul 2010 03:31:13 GMT

The free eZ Publish encyclopedia that anyone can edit. eZpedia has accumulated 598 english articles since 2006. We encourage you to create an account and create or edit a page yourself. Some folks create an article in the people namespace with their full name as the article name with a brief description of who they are, their interests, goals and objectives.

Ask A Question

Do you have an eZ Publish question, do you need an eZ Publish answer? Simply login and ask your question in our discussion forum. We publicly write free documentation based on your submissions. Posting on eZpedia is a great way to get answers you need and contribute to our freely available community documentation for eZ Publish.

Ecosystem

Read about what is going on within the various eZ Publish related websites on internet.

Checkout the latest reported news on anything eZ Publish via eZpedia (Recently, Email, Rss, Feeds, Updated, Discussion, New), eZ Share (Forums, Blogs, Articles, Tutorials), eZ Projects (WebSVN, ViewVC), PubSVN, eZ Publish Planet, eZ Publish, Developer, News, eZ Systems, Digg, FriendFeed or Twitter!

Recent development activity

Track the eZ Publish development progress through the roadmap by reviewing recent git activity from the github repository.

Recent discussions

Read what others are discussing

Chinese language of ezpedia.org

2010/03/22 @ 00:27:57 : Heath : Adding the cn siteaccess ...

Chinese language of ezpedia.org

2010/02/18 @ 11:46:57 : Xiongjie Chen : Good

Chinese language of ezpedia.org

2010/02/18 @ 11:25:46 : Heath : Taking the initiative ...

Chinese language of ezpedia.org

2010/02/17 @ 08:42:42 : Xiongjie Chen : Thanks Heath

Chinese language of ezpedia.org

2010/02/17 @ 04:19:56 : Heath : Great Idea!

Module

Sun, 25 Apr 2010 20:52:41 GMT

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

Module development

eZ publish provides for custom applications and components through support of many kinds of different extensions one of which is a module or custom module. Custom modules often use custom settings, designs, classes, cronjobs, workflows, triggers, etc. Custom module classes often extend the persistent object class.

Module extensions

The eZ publish kernel needs to know that your extension contains modules. In extension/ extensionname /settings/module.ini.append:

[ModuleSettings]
ExtensionRepositories[]=extensionname
ModuleList[]=modulename

By putting your module's name in the ModuleList setting array, you make sure that the eZ publish URL system does not reuse your module's URL as the nice URL of a content node.

Module definition

The actual definition of your module has to be placed in a file extension/extensionname/modules/modulename/module.php.

<?php  
 
$Module = array( 'name' => 'mymodule', 'variable_params' => false, 'ui_component_match' => 'module' );
$ViewList = array();
$FunctionList = array(); 
 
?>

The $Module array will contain global settings and data for your module. The following keys in this array are used by eZ publish:

Key	Type	Default	Usage
name	string		Alternative name of the module used in some debug statements (for example: Undefined view mymodule::foo when you try to access a non-existing view).
variable_params	boolean	false	Defines if you want to import variables into the view scipts' symbol table. When false you need to access the variables from the $Params array. You will find more information on this in the chapter "Views"
ui_component_match	string: module\|view	module	The string module (default) or view. Defines wether the module or view name will be used as the default ui_component for all views of this module
function	array		If your module contains only one view, then you can define the view here. The URl to the view will consist of only the module name.

$ViewList will contain the view definitions, you will find more information on views in the next chapter. $FunctionList will contain the policy function definitions, you will find more information on policy functions in the chapter "Policy functions".

Views

Definition

A module can have one or more views. You need to define your views in the $ViewList array. If your module contains only one view, you can also choose to define it with the "function" key in the module definition. If you define your view in this way, actions are not supported.

$ViewList = array();
$ViewList['viewname'] = array(
    'script' => 'myview.php',
     'params' => array( 'param1', 'param2' ),
    'ui_context' => 'navigation',
     'ui_component' => 'myuicomponent',
     'default_navigation_part' => 'ezmynavigationpart',
     'unordered_params' => array( 'param3ModuleName' => 'param3UrlName' , 'param4ModelName' => 'param4UrlName' ),
     'default_action' => array(
         array(
             'name' => '',
             'type' => 'post',
             'parameters' = array( 'postvariablename' ) ),
     'single_post_actions' => array( 'postvariablename' => 'actionname' ),
     'post_actions' => array( 'postvariablename' )
     'post_action_parameters' => array( 'actionname' => array( 'parametername' => 'postvariablename' ) ),
     'post_value_action_parameters' => array( 'actionname' => array( 'parametername' => 'postvariablenamestart' )
);

The keys of the $ViewList array are the names of the views, the values are the view definitions.

The following keys in your view definition are used by eZ publish:

Key	Type	Default	Usage
script	string		Filename of the view's PHP script.
params	array		The names of the parameters you can pass to the view by putting their values in the URL. For example: module/view/parametervalue
ui_context	string	navigation	Defines the UI context of the view.
ui_component	string	module or view name, depending on the "ui_component_match" key in the module definition	Defines the UI component of the view.
default_navigation_part	string		Defines the navigation part string of the view. The view result can override this.
unordered_params	array		The names of the parameters you can pass to the view by putting their name + value in the URL ( For example: module/view/(parametername)/parametervalue ). Please note the mapping here; in the view definition you define the name of the parameter in the url and also the according name for the parameter in the module script.
default_action	array
single_post_actions	array		If the current action is not yet determined it will use the definitions in module.php for finding out the current action. It first looks trough the single_post_actions array in the selected view mode, the key to each element is the name of the post-variable to match, if it matches the element value is set as the action. 'single_post_actions' => array( 'PreviewButton' => 'Preview', 'PublishButton' => 'Publish' )
post_actions	array		If none of these matches it will use the elements from the post_actions array to find a match. It uses the element value for each element to match agains a post-variable, if it is found the contents of the post-variable is set as the action. 'post_actions' => array( 'BrowseActionName' )
post_action_parameters	array		A 2-level array defining the POST variables that will be accessible in the module, depending on the current action. The array keys are the action names, the values are an array with the key being the post var. name and the value being the php var. name. 'post_action_parameters' => array( 'EditLanguage' => array( 'SelectedLanguage' => 'EditSelectedLanguage' ) )
post_value_action_parameters	array

Troubleshooting

Possible debug messages:

error "eZProcess", "PHP script $file does not exist, cannot run" The file specified with the "script" key doesn't exist. Maybe you misspelled it or you forgot to create it.

Policy functions

Coming soon. You can already take a look at http://ez.no/community/forum/developer/limiting_within_viewlist_possible and the policy functions feature documentation.

Fetch functions

See custom fetch.

Module php script

In the module definition you define which php script a module view should run. In that php script you can implement your custom functionality and return to module output as the module result. Usually the module result is the inner part of the pagelayout template. In order to return the module output you have to save the output as $Result['content'].

Module $Result

content	module output
pagelayout	a template file for a custom pagelayout, or a boolean false to skip using a pagelayout
path	see Module Path

Examples

Use a Custom Pagelayout

A module can have a custom pagelayout template located at this path: extension/my_module/design/standard/templates/my_module/pagelayout.tpl. To use it in your module.php:

$Result = array();
$Result['pagelayout'] = 'my_module/pagelayout.tpl';

Module Path

A module can have one or more views. You should to define your views path in the $Result['path'] array.

Examples

No URL

$Result = array();
$Result['path'] = array( array( 'url' => false, 'text' => 'Database Query Manager' ) );

Two levels without URL

$Result['path'] = array(
    array( 'url' => false, 'text' => 'Order ' ),
    array( 'url' => false, 'text' => 'Refund Completed' )
);

Multi-level with URL

$Result['path'] = array(
    array( 'url' => '/', 'text' => 'Home' ),
    array( 'url' => '/account', 'text' => 'My account' ),
    array( 'url' => '/account/addressbook', 'text' => 'Addressbook' )
);

Multi-level with URL and node ID

Adding node IDs to the path will help you to mark parent items as selected in the site menu. In this example "My account" will be selected if node 78 is a folder.

$Result['path'] = array(
    array( 'url' => '/', 'text' => 'Home' ),
    array( 'url' => '/My-account', 'node_id' => 78, 'text' => 'My account' ),
    array( 'url' => false, 'text' => 'Addressbook' )
);

You will also need to set a dummy node ID for the menu selection to work, e.g.

$Result['node_id'] = false;

Operations

...

Troubleshooting

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

External reference

Forum: Building a module for EZP 3.9
Forum: Detailed developer's tutorial for writing modules
Forum: Tutorial: How to make module
Forum: How to use a module
Forum: Module parameters
Forum: Extension & module generator
Forum: Module Path
Documentation: Building an eZ publish module
Documentation: Module tutorial (Part 1)

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

http://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.

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

xrowCDN connects eZ Publish with a Content Delivery Network

http://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=http://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

Simple fromString and toString interface for attributes

Fri, 29 Jan 2010 18:30:50 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: http://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

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.

OpenSearch

Fri, 08 Jan 2010 21:40:02 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 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('http://svn.projects.ez.no/opensearch/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

Cronjob

Mon, 04 Jan 2010 20:34:20 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

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:

Extended sort

Wed, 02 Dec 2009 12:18:58 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( 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.

Testing eZ Publish - Test System

Fri, 20 Nov 2009 22:20:50 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.2.x or newer: http://www.phpunit.de/
eZ Components

Installation

Update to at least trunk rev 22408.
Generate autoloads for the test system:

php bin/php/ezpgenerateautoloads.php -s

Running tests

To run all tests do:

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

The -D 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

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

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

Filter which tests to run

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

php tests/runtests.php -D 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 -D mysql://root@localhost/testdb --filter="testGlobBrace$"

This works too:

php tests/runtests.php -D 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 -D 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 -D mysql://root@localhost/testdb -g issue_13492

Writing tests

Naming conventions

The test system itself follows eZ Components naming conventions defined here: http://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 http://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 -D 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 -D 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

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: http://ez.no/doc/extensions/database
Download: http://projects.ez.no/ezoracle/downloads
News: http://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.

Package

Sat, 22 Aug 2009 15:26:21 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: Avoiding package download errors within setup wizard

If you ever have trouble during the setup wizard downloading default eZ Publish packages like eZ Flow or eZ Webin you can download these packages yourself from http://packages.ez.no/ezpublish/ into the 'packages' directory. Make certain the web server can read and write to all the files in the package directory.

Solutions

Creating, Managing, Deploying and Maintaining eZ publish Packages

External resources

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

http://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

http://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

Books

Sun, 16 Aug 2009 16:17:52 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.

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

Fifth 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

Fourth 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 available.

eZ Publish Content Management Basics

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 is expected to be released in the future.

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.

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.

It has not yet been updated with a second edition.

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

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 http:// 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: http://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

Humor

Sun, 09 Aug 2009 12:39:20 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: Cease and desist
Forum: A non-loss in the family ...
Forum: Advice...Should I use eZ Publish?
Forum: ezwebin design orignal photoshop/gimp files

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

Admin interface - Top menu

Sun, 09 Aug 2009 08:10:31 GMT

This feature is available since eZ publish 3.5.

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 visible top menu items of the admin interface are defined in menu.ini.

You can read more about it in the descriptive changelog.

Remove a menu item

If you for example don't use the built-in shop module, then the "Webshop" item in the top menu only takes unnecessary space. You can remove it by editing section 'TopAdminMenu' in the file, menu.ini.append.php:

[TopAdminMenu]
Tabs[]
Tabs[]=content
Tabs[]=media
Tabs[]=users
#Tabs[]=shop
Tabs[]=design
Tabs[]=setup
Tabs[]=my_account

External reference

Changelog: 3.5 menu ini settings description.
Forum: Accessing (admin) stats by a link
Forum: New tab in administration menu
Forum: Changing admin look
Forum: Webshop module how to remove it

Admin interface - Left menu

Sun, 09 Aug 2009 08:09:28 GMT

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

Custom left menu

This feature is available since eZ publish 3.8.

External resources

admin_left_menu feature doc
New extension - problem with the admin menu

Demo

Sun, 09 Aug 2009 08:06:37 GMT

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

About

You can use the existing public demos or build your own.

Demos

Public demo (login with: editor and publish or partner and publish)
Build your own demo

Datatype development

Sun, 09 Aug 2009 08:04:57 GMT

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

About

About this page

External resources

Class export and datatype

Daemon

Sun, 09 Aug 2009 08:03:43 GMT

For more on Daemon, see Daemon on Wikipedia

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

About

A daemon could be described as software process which runs waiting for a condition to match. This is similar in features to a simple cronjob which runs frequently and checks for a conditional match and performs tasks based on the condition, match or other variable.

Simple Example

A simple code example which starts a process which is repeated, like a condition and switch statement. Like a while function

$i = 0;
 
while ( $condition )
{
  print("Iteration Count: $i<br />\n");
 
  if( $i == 42 )
   print("Count == 42<br />\n");
 
  $i++
}

External reference

None

Custom Fetch

Sun, 09 Aug 2009 08:02:00 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. You can 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

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

External References

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

Coupon

Sun, 09 Aug 2009 08:00:37 GMT

For a general description of a coupon, we recommend Coupon on Wikipedia.

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

About

There are several coupon solutions available for eZ Publish.

Extensions

Coupon extension

Content view cache

Sun, 09 Aug 2009 07:58:55 GMT

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

Related extensions

UpdateCache

External resources

Conference

Sun, 09 Aug 2009 07:58:08 GMT

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

About

Each year, eZ systems organizes a conference.

The eZ conference includes a special show where eZ awards are given to key people within the eZ ecosystem.

Cluster

Sun, 09 Aug 2009 07:56:41 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

Chat

Sun, 09 Aug 2009 07:55:11 GMT

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

About

Web based live chat software

Options

Free

IRC! It's often a simple offering that is almost too simple for others needs

Non-free

Software which provides (web based) chat software often non-free. This thread on Live Chat Programs discusses some offers

References

Project: Unofficial Hab.la
Forum: Live Chat Programs
Forum: Chat with eZ Publish
Forum: Using IRC Web Based Chat through eZ
Forum: Integrating forums and chat

Cache

Sun, 09 Aug 2009 07:54:14 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

Browse

Sun, 09 Aug 2009 07:52:44 GMT

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

Description

About how to configure the browse views configuration settings which are not as well documented with examples.

Example

I was asked to add a custom start node (position) for browse to add an object relation. The addition of these setting to a new override/browse.ini.append.php solved the problem.

[BrowseSettings]
AliasList[]
AliasList[images]=51
AliasList[proimages]=2944
 
# Action for finding related objects
[AddRelatedObject]
StartNode=media
SelectionType=multiple
ReturnType=ObjectID
 
[AddRelatedObject]
StartNode=media
SelectionType=single
ReturnType=ObjectID
 
# Action for finding objects to related object datatype
[AddRelatedObjectToDataType]
StartNode=media
SelectionType=multiple
ReturnType=ObjectID
 
[AddRelatedObjectToDataType]
StartNode=proimages
SelectionType=single
ReturnType=ObjectID
 
# Action for finding objects to related object list datatype
[AddRelatedObjectListToDataType]
StartNode=media
SelectionType=multiple
ReturnType=ObjectID
 
[AddRelatedObjectListToDataType]
StartNode=media
SelectionType=single
ReturnType=ObjectID
 
# Action for finding images to related object datatype
[AddRelatedImageToDataType]
StartNode=media
SelectionType=multiple
ReturnType=ObjectID
 
[AddRelatedImageToDataType]
StartNode=media
SelectionType=single
ReturnType=ObjectID

Default Examples

Example browse.ini settings file contents

#?ini charset="iso-8859-1"?
# eZ publish configuration file for content browsing.
#
# NOTE: It is not recommended to edit this files directly, instead
#       a file in override should be created for setting the
#       values that is required for your site. Either create
#       a file called settings/override/browse.ini.append or
#       settings/override/browse.ini.append.php for more security
#       in non-virtualhost modes (the .php file may already be present
#       and can be used for this purpose).
 
# Settings for the browse page.
# For start nodes and top level nodes it is possible to use text aliases
# You can use the following aliases:
#  content - Represents the content root node defined NodeSettings/RootNode in content.ini, usually 2
#  users   - Represents the users root node defined NodeSettings/UserRootNode in content.ini, usually 5
# Other aliases are also possible by defining them in AliasList below
 
[BrowseSettings]
DefaultSelectionType=single
DefaultReturnType=NodeID
DefaultActionName=content
 
# A map of node aliases to node ids, here it's possible to define custom alias names
AliasList[]
#AliasList[images]=2
 
# The default value for maximum recent items to show
MaximumRecentItems=10
 
# Default list of top level nodes to show in browse page
# This will show the content and user node.
DefaultTopLevelNodes[]=content
DefaultTopLevelNodes[]=users
DefaultTopLevelNodes[]=media
DefaultTopLevelNodes[]=setup
 
# Example of action, the group name is named just what the action is named
# [ExampleAction]
# # The node ID where the browsing should start
# StartNode=content
# # Type of selection, possible values are:
# #   single - Allow for just one item to be selected
# #   multiple - Allow for multiple items to be selected
# SelectionType=single
# # The type of the return values, possible values are:
# #   NodeID - Returns the node ids of the selected items
# #   ObjectID - Returns the object ids of the selected items
# ReturnType=NodeID
# # Overrides for start node, the value begins with StartNode
# # and a _ (underscore) and the override key name to match
# # The key value is placed inside the [] (brackets)
# StartNode_classgroup[2]=users
# #
# # By specifying class identifier, only objects of specified class can be selected
 
[users]
StartNode=users
TopLevelNodes[]
TopLevelNodes[]=users
 
# Action used when assign a section in the node tree
[AssignSection]
StartNode=content
SelectionType=multiple
ReturnType=NodeID
 
# Action used to select source when exporting part on content tree
[ExportSourceBrowse]
StartNode=content
SelectionType=single
ReturnType=NodeID
TopLevelNodes[]
TopLevelNodes[]=content
 
[RSSExportImageBrowse]
StartNode=media
SelectionType=single
ReturnType=NodeID
Class[]=
Class[]=image
TopLevelNodes[]
TopLevelNodes[]=content
TopLevelNodes[]=media
 
# Action used to select destination and source in the RSS module
[RSSObjectBrowse]
StartNode=content
SelectionType=single
ReturnType=NodeID
TopLevelNodes[]
TopLevelNodes[]=content
TopLevelNodes[]=media
 
# Action used to select owner of imported objects in the RSS module
[RSSUserBrowse]
ReturnType=ObjectID
SelectionType=single
StartNode=users
Class[]
Class[]=user
TopLevelNodes[]
TopLevelNodes[]=users
 
# Action used when assigning a role to a user or user group
[AssignRole]
StartNode=users
SelectionType=single
ReturnType=ObjectID
Class[]
Class[]=user
Class[]=user_group
TopLevelNodes[]
TopLevelNodes[]=users
 
# Action used when the start of a subtree should be selected in policy editing
[FindLimitationSubtree]
ReturnType=NodeID
SelectionType=multiple
StartNode=content
 
# Action used when a node should be selected in policy editing
[FindLimitationNode]
ReturnType=NodeID
SelectionType=multiple
StartNode=content
 
# Action used when a node should be selected in discount rule edit
[FindProduct]
ReturnType=ObjectID
SelectionType=multiple
StartNode=content
 
# Action used when a user should be selected in discount view
[AddCustomer]
ReturnType=ObjectID
SelectionType=multiple
StartNode=users
TopLevelNodes[]
TopLevelNodes[]=users
 
# Action for newly created objects should select a node placement
# This action is used when a new object is to be created but no
# placement is known yet (for instance from the left menu).
[NewObjectAddNodeAssignment]
StartNode=content
SelectionType=single
ReturnType=NodeID
ActionName=SelectParentNode
StartNode_classgroup[2]=users
 
# Action for selecting a node placement for an object.
[AddNodeAssignment]
StartNode=content
SelectionType=multiple
ReturnType=NodeID
StartNode_classgroup[2]=users
 
# Action for selecting a node placement for an object.
[AddPrimaryNodeAssignment]
StartNode=content
SelectionType=multiple
ReturnType=NodeID
StartNode_classgroup[2]=users
 
# Action for moving a node placement
[MoveNodeAssignment]
StartNode=content
SelectionType=single
ReturnType=NodeID
StartNode_classgroup[2]=users
 
# Action for moving a node
[MoveNode]
StartNode=content
SelectionType=single
ReturnType=NodeID
StartNode_classgroup[2]=users
 
# Action for swaping a node
[SwapNode]
StartNode=content        
SelectionType=single
ReturnType=NodeID
StartNode_classgroup[2]=users
 
# Action for finding related objects
[AddRelatedObject]
StartNode=content
SelectionType=multiple
ReturnType=ObjectID
 
# Action for finding objects to related object datatype
[AddRelatedObjectToDataType]
StartNode=content
SelectionType=single
ReturnType=ObjectID
 
# Action for finding objects to related object list datatype
[AddRelatedObjectListToDataType]
StartNode=content
SelectionType=multiple
ReturnType=ObjectID
 
# Action for finding images to related object datatype
[AddRelatedImageToDataType]
StartNode=media
SelectionType=single
ReturnType=ObjectID
 
# Action for finding objects to related object datatype
[AddBookmark]
StartNode=content
SelectionType=multiple
ReturnType=NodeID
 
# Action for finding nodes when adding bookmarks
[AddSubtreeSubscribingNode]
StartNode=content
SelectionType=multiple
ReturnType=NodeID
 
# Action for finding placement for objectrelationlist
[SelectObjectRelationListNode]
StartNode=content
SelectionType=single
ReturnType=NodeID
 
# Action for finding placement for objectrelation
[SelectObjectRelationNode]
StartNode=content
SelectionType=single
ReturnType=NodeID
 
# Action for finding placement for toolbar node
[SelectToolbarNode]
StartNode=content
SelectionType=single
ReturnType=NodeID
 
# Action for finding placement for toolbar node
[SelectToolbarNodePath]
StartNode=content
SelectionType=single
ReturnType=NodeID
 
# Action for copying a node
[CopyNode]
StartNode=content
SelectionType=single
ReturnType=NodeID
 
# Action for copying subtree
[CopySubtree]
StartNode=content
SelectionType=single
ReturnType=NodeID
 
# Action for adding singe user limitation
[SelectSingleUser]
StartNode=users
SelectionType=single
ReturnType=ObjectID
 
# Action for adding multiple users and groups limitation
[SelectMultipleUsers]
StartNode=users
SelectionType=mutiple
ReturnType=ObjectID

References

Documentation: Missing browse.ini configuration file reference documentation
Setting: Global browse.ini from svn/trunk
Forum: Selecting multiple objects at once for object relations
Forum: Browsing for related objects: How to define default start nodes
Forum: Start related object browsing by the media folder
Forum: Set StartNode when browsing in browse ini

Blog

Sun, 09 Aug 2009 07:51:34 GMT

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

Extensions related to blogging

Blogs about eZ Publish

eZ Ecosystem OPML

Authentication

Sun, 09 Aug 2009 07:48:40 GMT

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

About

A brief word about shared authentication

Solutions

LDAP

LDAP is a strong solution

Login handlers

External reference

Documentation: Technical manual (3.8), Configuration Setting, LoginHandler
Solution: Intranet IP Based Authentication

Collected Information

Sun, 09 Aug 2009 06:50:55 GMT

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

About

About collected information

References

Doc: N/A

Suggestions: eZ publish Community

Sun, 09 Aug 2009 06:37:31 GMT

Warning, most of this text is very old and very day dreamy .... strike out items as needed.

Training

eZ publish Training Material
- eZ publish Training Lessons
- eZ publish Training Videos, Pickup where we (ezpub.co.uk) left off ...
- eZ publish Training Articles

Articles

Searching for eZ publish Solutions, An article about using advanced google searches, ez.no (site,doc,forum,community) searching techniques when looking through others past ideas, suggestions, solutions.

Community

eZ publish Community, Events, Developers Picture Link List (Forum/Wiki Article)

Development

eZ publish : Bounty Project : Community contributes to fund the creation of desired missing eZ publish functionality. (Examples)
eZ publish : Short URL Extension + Community Hosted Installation (through pubsvn) - Provides eZ publish url translation support for abreviated urls within eZ publish (*by default*, no interaction needed)
eZ publish : the external build : Community supported custom build of eZ publish svntrunk, extra tools, sane templates, configured to be functional out of the box, 100% compatible with ez.no builds and much more ... see: eZ publish (Community Edition) Roadmap : A build of eZ publish svn (stable/trunk) which includes the most popular and usefull additions from the community.
eZ publish : Integration with phpBB (see Related threads), Overriding eZ User Functions
Creation of Re: eZ publish : node counter eZ template operator, Operator Guide, Extension Introduction, Advanced Counter Features
Creation of user created contribution Rating (submit to ez.no for use on the site) (Re: Impimentation of Luke’s eZArticleRating)
Admin / Online Editor / xmleditor : Admin extention to provide dynamic custom tag management (enabled|disabled|edit|add) screens to add/edit custom tag template.
Extention : RSS Feed (v2+) PowerPack ( Advanced, Import (w/cronschedualing), Export (again&), Per Content Object / Node ... ) Feeds For Forums (#1), Avanced Import (Syndication Sites), Contribution Feed....System...
(Implimentation/tpl/etc) User : Hiding Semi Light Blue Transparent / Gradiant Bg Container + White Inner Container (design) for collapsable / hidden div icon/to/ 1/5th of the right hand side absolute with js scroll of large list of names, br tag, location ... user bookmarks ( ez projects (dev project implimentation for ez.no), ez contacts ( part of ez directory ), live ez.no js/soap/ im system ( the best of all text communites, lots of views ( views are the hangouts, user selects the ones they like, as preferences. ... live help system ...
prototype the extra forums views, build a test bed of data ... Lorum Ipsum Content Generator.
eZ publish (cross-platform; free software) gui class builder ... ( strong developer product + editor + active session development tool (tracing, breakpoints, ...) )
eZ publish package repository framework (multi repository, primaries + user defined / community ), host packages, manage (add,edit,delete,...) | (client / client / server), user / admin login / request for permissions, (add/edit/etc) package repositories .... host packages, assess, handle package dependancies (don’t exist in eZ pkg? methods?), mirrors ( 1 - 3 + users ), checkUpdate (gets repository subversion and compares against the last / current / cached subversion (+plus date), if outdated, check preference (no prompt) or prompt user to get Packages, getPackageHeaders(), getPackage(), getPackages(), getNewPackages(), installedPackages, currentPackages, uninstallPackage, updatePackage, updateAllPackage(), updatePackages(), (save package as file / pkg / expand / open), check dependanciees, resolve dependancies, install package

Knowledgebase

eZ publish could really use a rich knowlege base application with user controled / preferences sorting preferences / order / views .. rating/print/pdf/tip/comment/forum?

Forums

eZ publish : forum : templates - Updated eZ publish forum functionality + templates to provide common forums functionality inside of eZ publish directly.

Beter forum searching (ezsearch)
Beter forum user options

Disable Toggles: Avitar/Picture, Signature, Posted Name / Company Name (Toggle)
Search / List a specific Users posts ( i want to see all of kracker’s posts in a list )

Forum Soft Sorting (Sticky), Dynamicly Shift Sort / Display Order (3 levels), By Date Posted, Date Updated, Most Active, Least Active, ...
Expanded Forum Views

Per Category (Latest Messages (user configurable thread limit 5 - 50) )
Root Category (Latest Messages (user configurable thread limit 5 - 50) )
Per Thread (User Thread Display limit (currently static) (10 - 25 Replys),
Deep linking to a specific post in a 2 - 5 page thread does not link to the last page w/ to the post.
Per Thread / Per Reply Title Should be a href link without style to be bookmarkable directly (currently it’s not)

ummm ... make them beter!

Thread View : Footer : Random Faq (Help users get femiliar with commonly used eZ publish solutions)
I wrote a lot of ideas accidentaly into this general eZ publish thread on ez.no

Design

Customize the ezpedia design and colors.
Convert 3 - 5 designs from oswd static html into eZ publish site designs. Release designs to community in ezpkg format.

Your life as everyone\'s file 13

eZ Forum User Features
View: Gallery of Users Forum Avetar Icons Uploaded ( i\’ve updated well over 50, and i know they are still in the system, but de referenced, i want to view them and be able to use them again as my forum user avetar icon)
Feature: Rotate Forum Avetar Icon (Randomly/Order) from user avetar icon)
Search ez.no documentation directly from your browser

intranet: forum : view : ebay aproch to watch active converstation.
use case: browse forums as normal only difference is you can eith checkbox select or click (link) select forum categories ( yes you can add either categories or topics (mostly topics as there are only few categories currently)
selecting and submiting a watchlist select ion stores the selection and redirects to the user\’s watchlist / dashboard which they have a larger set of display customization options for both viewing new topics, outdated, dead, active threads in a category (controll type + threshold/limit)
display forum view count per message, display image rank 100% of most popular / active forum categories / threads (long list?)
external views vs changing existing forum views ....hrm

eZ publish Developoment Best Practices
1. Develop with SVN, Release with Stable
Use svn as it has development / managment tools not available with eZ publish stable zip releases / builds.

Managing a production, beta, dev, alpha and post (development) environment and just how to move a new application / site out through alpha to dev to beta to production, ( and after first release ...) move the eZ publish application\’s database, var/ dir, settings/, design/, extentions/, packages, etc... (to retain the revised production runtime configuration (as tested and tweaked for optimium performance) in the next dev release out on it\’s way to production...
Return to Development (From Beta/Production/Post (w/descriptions)
1. Alpha : Staging Server (open directory listing for quick dev / statick / basic proto)
Dev : Primary Development Server (All VirtualHosts + Admins)
Beta : Primary Beta Application Server (All VirtualHosts + Admins) :
1. 1. Resource for Developers to release the application for build and installation into a separate staging server (/resource) for clients to review, test, experiment, aprove todate / total application revisions and their release / schedual for the downtime window\’s release of the application.
2. Production : The Primary Production Server (Preferably a 1 - 3 httpd server pool, nas, + postgress db server pool)
Post : The Secondary FallBack Server ( keeps a hot running standby of the revisions depricated by production releases (automated moves), this data is for emergency / just in case / security backsups, not really needed or wanted untill something really bad happens to the production var/ or db resources)
Client Task / Request Managment Systems + Dashboard ( to direct clients to their managed resources, production-web, production-admin, beta-web, beta-admin, (for devs too for pm managment), websvn/viewscvs commit history, release history (per production release)

eZ Tips

mysqldump performance tip, enable extra mysqldump options to reduce the time it takes to backup large databases into tar.gz backup files with one command. References: #1, AutoMysqlBackup, #3, #4
(class builder / ezpkg) If your like me, you dislike creating large complex class\’s inside the cumbersome and slow eZ publish admin class builder. I suggest trying to create a class definition file by hand by creating a class-definition.xml file and package xml file entries and packaging up an ez package of your hand-created eZ publish class and installing it into your eZ publish installation for testing and use.
- eZ publish offers several built-in R.A.D. tools ( http://example.org/news_admin/setup/rad ) (but i\’ve yet to find out just how they are usefull).
  1. Datatype Wizard
Template operator wizard

Promotion

eZ counter : eZ publish Counter Project : (like the registered linux users project), Users sign up for an account to prove their worth as an eZ publish user. Features: Member Since, eZ Versions, Member Type (Avocate, User, Personal, Developer, Business, Consultant, Etc), Installation Count, etc ...
List of most useful eZ publish : ez.no : contributions + implementation notes.
Introduction to eZ publish 3 : The Lost Beginners Book, Created for newbies : Created by the community : GNU FDL Content et ala, svnbook.red-bean.com style
eZ publish : T-Shirts : Cool Shirts, Promotional Junkets, Community ‘Pride’
Start an eZ publish user group, have your user group listed on ez.no
References: Details on how to connect to #ezpublish irc channel. #1, #1
Promote eZ publish irc : #ezpublish

eZ today

Hello, world. i’m quietly pine’ing for the return of my blog on blog(s). temp section branding download(s) to core ...

I should be sleeping ... the tv won’t do it anymore ...

Things no one else has addressed (yet has been drop’d):

Apache Access / Error Log Analyser / Staticics Package : With Extensability to store log information into rolling log stats database ... per application ... with interoperablity to provide statistics information to other software constructs ie: back into eZ publish for stats template programing and dispaly. Requires: Existing Apache Log + Stats Platform + With Extensablity + eZ publish : eZ statistics / eZ apache logs / eZ httpdobjectstatistics
eZ publish 3 extention : shop : customers who purchased $item also purchased $item(s) tpl container. see bottom
eZ publish extention : ircbot : wrapper for irc bot : a flexible solution to irc conversations / logs / entries into eZ publish. eZ irc log? Ref: eZ publish : irc agent
An xul/firefox extention to providing a replacement (inc, removal) of add bookmark with blog bookmark to preselected profile / selectable profile blogs (i have several), bottom line: the browser adds content to my blog’s incoming category pending my review / commenting / re categorizing / publishing. I bookmark to a webapp thats can be / has views with blog / deep tree hiegheracical trees. the bookmarks themselves are not bookmarks but bookmark objects instantiated on behalf of the client browsers triggers instead of a traditional web app ui, with the thinking. what i consume online is what i would write about, ie i want to write when i’m not in front of my blog webapp ui, in fact it usualy makes it harder to throw out subjects and come back to add to the bookmark ....

Importing compressed zip package images

Sun, 09 Aug 2009 04:50:27 GMT

About

Imports a zip filled with images into eZ Publish into a gallery. This is a mass images import solution.

http://ez.no/community/contribs/import_export/coolzipimport_zip_with_images_mass_import

Description

After our experiences with eZ WebDAV on MAC OS X , we made a production save and fast method to import a folder of images at once.

Install extension as usual.
Clean cache
Go to: http://www.example.com/ezpublish-...n_site_admin/coolzipimport/import
Choose .zip
Browse place
wait
enjoy.
Live:
Sorry, nothing to see, used in the extranet at http://www.doerre-fotodesign.de

Credits

http://www.coolscreen.de
Based on the oo extension
http://ez.no/community/contribs/import_export/openoffice_org_extension
Contact:
http://www.coolscreen.de/kontakt/
Third party:
PhpConcept Library - Zip Module: Vincent
OpenOffice.org extension: Bard

=== More Information and Forum: ===

Screenshot
Changelog
-- 1.0.0 initial
Comments

Testing eZ Publish

Sun, 09 Aug 2009 04:43:08 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 is a great article on Testing eZ Publish with Selenium.

References

Article: Testing eZ Publish with Selenium
Doc: eZ Publish Test System
Doc: eZ publish Test Suite

best_sell_list

Sun, 09 Aug 2009 02:49:07 GMT

This feature is available since eZ publish 3.9.

Title

' best_sell_list' is an extended fetch function

Summary

Several new parameters were added to 'shop', 'best_sell_list' fetch function to give a possibility to fetch list of most sold products for a certain time duration.

Usage

fetch( 'shop', 'best_sell_list',
       hash( [ 'top_parent_node_id', parent_node_id, ]
             [ 'offset', offset, ]
             [ 'limit', limit, ]
             [ 'start_time', start_time, ]
             [ 'end_time', end_time, ]
             [ 'duration', duration, ]
             [ 'ascending', ascending, ]
             [ 'extended', extended, ]
              ) )

Parameters

Name	Type	Required
top_parent_node_id	integer	yes
offset	integer	no
limit	integer	no
start_time	integer	no
end_time	integer	no
duration	integer	no
ascending	boolean	no
extended	boolean	no

Examples

List Example

{def $best_sellers=fetch( 'shop', 'best_sell_list',
                          hash( 'top_parent_node_id', 2,
                                'limit', 5,
                                'offset', 0,
                                'start_time', maketime( 0, 0, 0 ),
                                'duration', mul( 60, 60, 24 ),
                                'extended', true() ) ) }
 
<h2>Best Sellers</h2>
 
<ul>
{foreach $best_sellers as $product}
    {* $product.object|attribute(show,1) *}
    <li><a href={$product.object.main_node.path_identification_string|ezurl}>{$product.object.name}</a></li>
    {* <td>{$product.count}</td> *}
{/foreach}
</ul>
{undef}

Table Example

{def $best_sellers=fetch( 'shop', 'best_sell_list',
                          hash( 'top_parent_node_id', 2,
                                'limit', 5,
                                'offset', 0,
                                'start_time', maketime( 0, 0, 0 ),
                                'duration', mul( 60, 60, 24 ),
                                'extended', true() ) ) }
 
<table>
{foreach $best_sellers as $product}
    <tr>
    <td>{$product.object.name}
    <td>{$product.object.main_node.path_identification_string}
    <td>{$product.count}
    </tr>
{/foreach}
</table>
{undef}

External Reference

Workflow

Sat, 08 Aug 2009 21:22:31 GMT

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

About

While a complex concept in general eZ publish workflow event system is very basic in nature.

State

Notion of workflow predefined status code returns

Trigger

A Workflow event is executed based on settings which bind a workflow event class to a module trigger.

Workflow Type Status List

These are available in eZ publish by default

Name	ID	Description
EZ_WORKFLOW_TYPE_STATUS_NONE
EZ_WORKFLOW_TYPE_STATUS_ACCEPTED		Accepted event
EZ_WORKFLOW_TYPE_STATUS_REJECTED		Rejected event
EZ_WORKFLOW_TYPE_STATUS_DEFERRED_TO_CRON		Event deferred to cron job
EZ_WORKFLOW_TYPE_STATUS_DEFERRED_TO_CRON_REPEAT		Event deferred to cron job, event will be rerun
EZ_WORKFLOW_TYPE_STATUS_RUN_SUB_EVENT		Event runs a sub event
EZ_WORKFLOW_TYPE_STATUS_WORKFLOW_CANCELLED		Canceled whole workflow
EZ_WORKFLOW_TYPE_STATUS_FETCH_TEMPLATE
EZ_WORKFLOW_TYPE_STATUS_FETCH_TEMPLATE_REPEAT
EZ_WORKFLOW_TYPE_STATUS_REDIRECT
EZ_WORKFLOW_TYPE_STATUS_WORKFLOW_DONE
EZ_WORKFLOW_TYPE_STATUS_REDIRECT_REPEAT
EZ_WORKFLOW_TYPE_STATUS_WORKFLOW_RESET		Workflow was reset for reuse
EZ_WORKFLOW_STATUS_DONE

Workflow events implement their custom logic and use the above return codes for most basic workflow events.

Advanced Workflow Processes

There are even more workflow event systems which provide their own unique and often advanced functionality. For a example ...

ezaprove
ezaprove2
ezmultiplexer
ezsimpleshipping
ezwaituntilldate
ezpaymentgateway

Describing each of the advanced workflow components generic functionality offered and how to use it as offered.

Example Workflow Types

Workflows based on using specific trigger + custom code

Shop
- Shop / Add to basket
- Shop / Update basket
- Shop / Checkout
- Shop / Confirm order

Shop : Payment Gateway
- Shop / Payment Information Entry
- Shop / Payment Authorization

Publish
- Before / After content object publish

Workflows based on workflow event + some trigger ...

Approval workflow system
Multi workflow system
Shipping workflow event
Wait until date event

External reference

Doc: Technical manual concepts and basics workflows
Doc: Workflow event type

Rewrite

Thu, 06 Aug 2009 11:01:58 GMT

About

mod_rewrite uses a rule-based rewriting engine (based on a regular-expression parser) to rewrite requested URLs on the fly.

It supports an unlimited number of rules and an unlimited number of attached rule conditions for each rule, to provide a really flexible and powerful URL manipulation mechanism.

Quotes

``The great thing about mod_rewrite is it gives you all the configurability and flexibility of Sendmail. The downside to mod_rewrite is that it gives you all the configurability and flexibility of Sendmail.'' -- Brian Behlendorf | Apache Group
`` Despite the tons of examples and docs, mod_rewrite is voodoo. Damned cool voodoo, but still voodoo. '' -- Brian Moore

Performance

mod_rewrite enabled apache services perform faster than .htaccess for production services; performance best practices solution.

Enable mod_rewrite

Virtual host setup

Alternatives

.htaccess apache configuration rules

These .htaccess files are faster to use for development without additional configuration.

These are useful for some users who avoid apache configuration or virtual host configurations.

eZpedia : eZ

Main page

Ask A Question

Ecosystem

Recent development activity

Recent discussions

Recently updated articles

Module

Module development

Module extensions

Module definition

Views

Definition

Troubleshooting

Policy functions

Fetch functions

Module php script

Module $Result

Examples

Use a Custom Pagelayout

Module Path

Examples

No URL

Two levels without URL

Multi-level with URL

Multi-level with URL and node ID

Operations

Troubleshooting

External reference

AMF

About

References

Amazon

About

Extensions

Known Issues

References

Install

About

Articles

References

eZ publish 3.9

Installation

Upgrading

Using old site packages

New features

Website interface extension

Additional content creation and import features

Best Selling Product Fetch

Kernel Error Codes

Setup wizard finish custom text

Contributor / third party software / extension information

External resources

Import

CSV / DSV

Additional content creation and import features

OpenDocument

PowerPoint

RSS

OPML

XML

Import Framework

Misc

References

Simple fromString and toString interface for attributes

Simple fromString and toString interface for attributes

OpenSearch

Introduction

Plugins

Installation

Update

Usage

Using these with eZ publish

Support

Browsers

Credits

License

Copyright

External reference

Cronjob