The eZ Coding standards need you !

Thursday 26 May 2011 9:09:01 am

By : Bertrand Dunogier

In our continuous effort to open eZ Publish to both our community and professional partners, we have worked on establishing coding standards that will help uniformize how our software is written and organized.

Since you, community members, are contributing more and more to eZ Publish, by means of pull requests or extensions, it only makes sense to ask for your feedback before we publish a first version of these standards.

You can see the current version as a public google document: https://docs.google.com/document/d/1r3ZV8yiwSQWi3KttVDj0Pv1QZVJ89AXoabzcMxnNYYs/edit?hl=en_GB. Go through it, even if it is only a little, and please, let us know what you think should go in there or could be improved.

The standards will be open for review until the 14th of june.

In order to contribute more efficiently, you can request write access to the document. To do so, you need to give us your share login as well as a gmail address:

  • post a comment to this blog post
  • send a twitter message to Nicolas Pastorino (@jeanvoye) or myself, Bertrand Dunogier (@bdunogier)
  • drop us an email (nfrp [at] ez [dot] no or bd [at] ez [dot] no).

Keep in mind that this document is a living one. As our developement methodologies, or global techniques, evolve, the document will be updated.
We do thank you in advance for the time you will spend on this, and are eagerly looking forward to your input. Cheers !

Feedback log
  • "Torough documentation" => "Thorough documentation" (Bruce Morrisson)
    Fixed
  • No mention of line length (Bruce Morisson)
  • Need precisions about UpperCamelCase / LowerCamelCase / prefixes (Matthieu Sévère)
    Replied in comments, not improved yet in the document
  • FooProvider::factory() isn't prefixed and isn't in LowerCamelCase (Matthieu Sévère)
    Fixed
  • What about //autogentag// in extensions (Yannick Komotir)
    Replied in the comments
  • Heredoc example is misleading (Donat Fritschy)
    Fixed
  •  
Powered by eZ Publish™ CMS Open Source Web Content Management. Copyright © 1999-2014 eZ Systems AS (except where otherwise noted). All rights reserved.

eZ debug

Timing: Jan 18 2025 00:01:52
Script start
Timing: Jan 18 2025 00:01:52
Module start 'layout'
Timing: Jan 18 2025 00:01:52
Module start 'content'
Timing: Jan 18 2025 00:01:52
Module end 'content'
Timing: Jan 18 2025 00:01:52
Script end

Main resources:

Total runtime0.0877 sec
Peak memory usage6,144.0000 KB
Database Queries40

Timing points:

CheckpointStart (sec)Duration (sec)Memory at start (KB)Memory used (KB)
Script start 0.00000.0052 589.1563152.6406
Module start 'layout' 0.00520.0027 741.796939.4844
Module start 'content' 0.00790.0781 781.2813366.5781
Module end 'content' 0.08600.0017 1,147.859414.3984
Script end 0.0877  1,162.2578 

Time accumulators:

 Accumulator Duration (sec) Duration (%) Count Average (sec)
Ini load
Load cache0.00333.8064150.0002
Check MTime0.00121.3549150.0001
Mysql Total
Database connection0.00070.844810.0007
Mysqli_queries0.036341.4059400.0009
Looping result0.00030.2944370.0000
Template Total0.061670.220.0308
Template load0.00212.408720.0011
Template processing0.059567.801220.0297
Template load and register function0.00010.115210.0001
states
state_id_array0.00030.322610.0003
state_identifier_array0.00070.775220.0003
Override
Cache load0.00182.0018370.0000
Sytem overhead
Fetch class attribute name0.00161.833120.0008
class_abstraction
Instantiating content class attribute0.00000.006820.0000
General
dbfile0.00171.9119100.0002
String conversion0.00000.010640.0000
Note: percentages do not add up to 100% because some accumulators overlap

Templates used to render the page:

UsageRequested templateTemplateTemplate loadedEditOverride
1node/view/full.tplblog_entry/full.tplextension/community_design/design/suncana/override/templates/blog_entry/full.tplEdit templateOverride template
2content/datatype/view/ezxmltext.tpl<No override>extension/community_design/design/suncana/templates/content/datatype/view/ezxmltext.tplEdit templateOverride template
2content/datatype/view/ezxmltags/link.tpl<No override>design/standard/templates/content/datatype/view/ezxmltags/link.tplEdit templateOverride template
3content/datatype/view/ezxmltags/paragraph.tpl<No override>extension/ezwebin/design/ezwebin/templates/content/datatype/view/ezxmltags/paragraph.tplEdit templateOverride template
7content/datatype/view/ezxmltags/li.tpl<No override>design/standard/templates/content/datatype/view/ezxmltags/li.tplEdit templateOverride template
2content/datatype/view/ezxmltags/ul.tpl<No override>design/standard/templates/content/datatype/view/ezxmltags/ul.tplEdit templateOverride template
6content/datatype/view/ezxmltags/line.tpl<No override>design/standard/templates/content/datatype/view/ezxmltags/line.tplEdit templateOverride template
1content/datatype/view/ezxmltags/header.tpl<No override>design/standard/templates/content/datatype/view/ezxmltags/header.tplEdit templateOverride template
5content/datatype/view/ezxmltags/emphasize.tpl<No override>design/standard/templates/content/datatype/view/ezxmltags/emphasize.tplEdit templateOverride template
1print_pagelayout.tpl<No override>extension/community/design/community/templates/print_pagelayout.tplEdit templateOverride template
 Number of times templates used: 30
 Number of unique templates used: 10

Time used to render debug report: 0.0001 secs