powercontent

Table of contents:

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

Power Content

The Power content module allows one-click publishing or pre-filling of attributes, similar to the Object Creator extension.

However, it uses content/edit for the final processing. This module has one big advantage: it can deal with any type of attribute, even new custom ones.

Documentation

Compatibilty

3.10, 4.0

Usage

Installation instructions

1. Enable the extension (in site.ini.append or by using the admin interface)
2. Add a policy for this module to the desired roles.

How to use in your template

The main idea is to add new attributes that are going to contain the values you want instead of the default ones on ez publish. This module associate these new fields with standard fields that exist when editing with the default edit template. Therefore, you have to understand how ez names these fields so you can add the values you want.

A typical naming scheme for the input fields of an attribute is: 

ContentObjectAttribute_[some attribute specific name]_[contentobjectattribute id]

For instance the name for the fields of an articles are (do a view source of the page when you're editing an article):

- title: ContentObjectAttribute_ezstring_data_text_1105
- into: ContentObjectAttribute_data_text_1108

(1105 and 1108 are contentobjectattribute identifier numbers that are going to be different on your installation.)

You will have to to change these names to: 

powercontent_[contentclassattribute identifier]_ContentObjectAttribute_[some attribute specific name]_pcattributeid

For the article, it would be:

-title: powercontent_title_ContentObjectAttribute_ezstring_data_text_pcattributeid
-intro: powercontent_intro_ContentObjectAttribute_data_text_pcattributeid
When the Power Content module processes this kind of post variables, it will take their content and put them into the proper fields as if the user would have inputed it (it will inject fake post variables where the string "pcattributeid" will be replaced by the expected contentobjectattribute id).
On the top of the parameters you want to "prefill", you have to provide a few additional ones:

  • NodeID: The nodeid of the parent object you want to create (as an option, you can put "UserNode", that will put create it under the usernode of the currently logged in user)
  • ClassIdentifier: The class identifier of the object you want to create (you can provide either the class identifier or the class id, no need for both)
  • CreateButton: a submit button

You have more optional parameters:

  • RedirectToMainNodeAfterPublish: if you have installed and enabled the redirect extension, then you can use this post variable to redirect to the main node of the newly created object after publishing it.

powercontent_attribute_create_gui function

The powercontent_attribute_create_gui eases the process of creating the attribute input fields with the correct names for the powercontent extension.

Example of its usage: 

{powercontent_attribute_create_gui class_attribute=$folderClass.data_map.name}

Currently there are templates included for the following datatypes:

  • Checkbox
  • Country
  • Date
  • E-mail
  • Enhanced selection
  • File
  • Float
  • Integer
  • URL
  • Selection
  • Text block
  • Text line

Feel free to commit yours to svn.

Examples code

1) Example code for the "article" content class. This will prefill the title and intro of the article: 

<form method="post" action={"powercontent/action/"|ezurl}>
  <div class="buttonright">
  <input type="hidden" name="NodeID" value="{$owner.contentobject.main_node_id}" />
  <input type="hidden" name="ClassIdentifier" value="article" />
  <input type="hidden" name="powercontent_title_ContentObjectAttribute_ezstring_data_text_pcattributeid" value="A new article on my blog" />
  <input type="hidden" name="powercontent_intro_ContentObjectAttribute_data_text_pcattributeid" value="A new intro on my blog" />
   <input class="classbutton" type="submit" name="CreateButton" value="New article" />
</div>
</form>

2) Example code for the "File" content class: 

<form method="post" action={"powercontent/action"|ezurl} enctype="multipart/form-data">
    <div>
    <input type="hidden" name="NodeID" value="{$node.main_node_id}" />
    <label>Publish immediately:</label> <input type="checkbox" name="DoPublish" checked="checked" />
    <input type="hidden" name="UseNodeAssigments" value="0" />
    <input type="hidden" name="ClassID" value="12" />
    <input type="hidden" name="RedirectURIAfterPublish" value="/{$node.url_alias}" />
    </div>
 
    <div>
    <label>File:</label>
    <input class="box" name="powercontent_file_ContentObjectAttribute_data_binaryfilename_pcattributeid" type="file" />
    </div>
    <div>
    <label>Title:</label>
    <input type="text" name="powercontent_name_ContentObjectAttribute_ezstring_data_text_pcattributeid" value="" />
    </div>
    <div>
    <input class="button" type="submit" name="CreateButton" value="Create" />
    </div>
</form>
</pre>

License

Powercontent is copyright (C) 2006-2007 SCK•CEN, 2008 Kristof Coomans and is licensed under the GNU-GPL.

External reference

All text is available under the terms of the GNU Free Documentation License

Powered by eZ Publish 4.0.3

Hosting by Swiss eZ Publish partner YMC