eZPublish templates in Eclipse

By | 15 Jul 2008

Syntax-highlighting and Code-completion

With the Smile eZ Publish-plugin for Eclipse, there is syntax highlighting and code-completion for eZ Publish-templates. But this only works if you open the .tpl-files out of a project.

If not already set, at the configuration page Window → Preferences… → General → Editors → File Associations → *.tpl select Open With… → Smile TPL Editor. Alternatively you can use the JAC eZ Template Editor which is included in that plugin.


  1. Help → Software Updates → Find and Install…
  2. (X) Search for new features to install
  3. Click Next >
  4. New Remote Site…
  5. Name: Smile ezPublish
  6. URL: http://smile-ez-plugin.sourceforge.net/update/
  7. Click OK
  8. make sure that the new entry is checked
  9. below: Finish
  10. install the plugin as usual

Template-validating and Class-browser

To get these features you have to download the Smile eZ Publish Extension and install it into eZ Publish. Enable the extension smileclasses at the eZ-Adminpanel.

In Eclipse, go to your project settings, open the page eZ Publish and at Server enter the URL to the smileclasses-export, e.g. http://foobar.com/ezpublish/smileclasses/export. Web root might be the local filepath to the main directory of the server (don’t know if this is used, it isn’t mentioned in any documentation). You might also enable the template validation.

If everything is correct, at Window → Show View → Other… → Smile eZ Publish you can activate the Classes View to see all eZ Publish-classes.

Note: On sites with RequireUserLogin=true you have to add both smileclasses-functions to the AnonymousAccessList[]. (see here).

2 thoughts on “eZPublish templates in Eclipse

  1. Rudy Jaumain

    I can’t get this to work, please help ! I’m running Eclipse Helios
    I installed the plugin correctly, as long as activating it in the admin.
    I can’t give Eclipse the right URL for the server though, server gives no response says Eclipse.
    The Ez Classes View doesn’t display the input.

    I tried opening files in and out a project and no syntax-highlighting appeared…

    I created the simplest project file possible, should I choose an other project type ?

    Any help for a beginner would be great ! Thx

  2. Brandon

    Well, this is very interesting indeed. Would love to read a little more of this. Good post. Thanks for the heads-up.


Leave a Reply