Files
ofbiz-framework/framework/widget/dtd/widget-theme.xsd
T
Nicolas Malin 2e1cacb2a8 Improved: Improve error message page to support Theming
(OFBIZ-10753)

When OFBiz raise an error, the framework use a jsp page to display it.
I improved the error page generation to support also ftl template rendering and by this way extend the theme engine to support to overide it

On controler.xml we can now use :
    <errorpage>/error/error.jsp</errorpage>
or 
    <errorpage>component://common/webcommon/error/Error.ftl</errorpage> (default configuration)

On your theme you can add your own error page :
    <template> 
      ...
      <template-file widget=menu location=component://common-theme/template/macro/HtmlMenuMacroLibrary.ftl/>
    + <template-file widget=error location=component://common-theme/template/ErrorPage.ftl/>
    </template>

The component://common/webcommon/error/Error.ftl contains the logic theming connection and to simplify source code, all framework old error page (error.jsp) have been removed to centralize all on this new page.

Thanks to Marine Desmarchelier for the error page design

git-svn-id: https://svn.apache.org/repos/asf/ofbiz/ofbiz-framework/trunk@1856175 13f79535-47bb-0310-9956-ffa450edef68
2019-03-25 09:31:02 +00:00

242 lines
11 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" xmlns="http://ofbiz.apache.org/Widget-Theme" targetNamespace="http://ofbiz.apache.org/Widget-Theme">
<xs:element name="theme">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="1" ref="visual-themes"/>
<xs:element minOccurs="0" maxOccurs="1" ref="extends"/>
<xs:element minOccurs="0" maxOccurs="1" ref="widget-properties"/>
<xs:element minOccurs="0" maxOccurs="1" ref="theme-properties"/>
<xs:element minOccurs="0" maxOccurs="1" ref="templates"/>
<xs:element minOccurs="0" maxOccurs="1" ref="common-screens"/>
<xs:element minOccurs="0" maxOccurs="1" ref="common-menus"/>
</xs:sequence>
<xs:attribute type="xs:string" name="name" use="required" />
</xs:complexType>
</xs:element>
<xs:element name="visual-themes">
<xs:annotation><xs:documentation>List all visual themes embded by this theme</xs:documentation></xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="unbounded" ref="visual-theme" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="visual-theme">
<xs:annotation><xs:documentation>Define a visual theme with an unique id and some meta information</xs:documentation></xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="1" ref="description" />
<xs:element minOccurs="0" maxOccurs="unbounded" ref="screenshot" />
</xs:sequence>
<xs:attribute type="xs:string" name="id" use="required" />
<xs:attribute type="xs:string" name="display-name" use="required" />
</xs:complexType>
</xs:element>
<xs:element name="description"/>
<xs:element name="screenshot">
<xs:annotation><xs:documentation>List all screenshots image with the path to use from web site (ex '/mytheme/screenshot1.jpg' for an image in ofbiz/themes/mytheme/webapp/screenshot1.jpg)</xs:documentation></xs:annotation>
<xs:complexType>
<xs:attribute type="xs:string" name="location" use="required" />
</xs:complexType>
</xs:element>
<xs:element name="extends">
<xs:annotation><xs:documentation>Indicate the theme to extend if you when improve an existent theme like common-theme. You need to define the path to the theme definition to surcharge (ex: component://common-theme/widget/Theme.xml)</xs:documentation></xs:annotation>
<xs:complexType>
<xs:attribute type="xs:string" name="location" use="required" />
</xs:complexType>
</xs:element>
<xs:element name="widget-properties">
<xs:annotation><xs:documentation>
This element contains all properties use by the screen engine that the theme can be dedicate some values
</xs:documentation></xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="default-view-size">
<xs:complexType>
<xs:attribute type="xs:integer" name="value" />
</xs:complexType>
</xs:element>
<xs:element name="autocompleter">
<xs:complexType>
<xs:attribute type="xs:integer" name="default-view-size" />
<xs:attribute type="xs:integer" name="default-min-lenght" />
<xs:attribute type="xs:integer" name="default-delay" />
<xs:attribute name="display-return-field"
type="xs:boolean"/>
</xs:complexType>
</xs:element>
<xs:element name="lookup">
<xs:complexType>
<xs:attribute type="xs:integer" name="height" />
<xs:attribute type="xs:integer" name="width" />
<xs:attribute name="position">
<xs:simpleType>
<xs:restriction base="xs:token">
<xs:enumeration value="top-left"/>
<xs:enumeration value="top-right"/>
<xs:enumeration value="bottom-left"/>
<xs:enumeration value="bottom-right"/>
<xs:enumeration value="center"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute name="show-description">
<xs:simpleType>
<xs:restriction base="xs:token">
<xs:enumeration value="Y"/>
<xs:enumeration value="N"/>
</xs:restriction>
</xs:simpleType>
</xs:attribute>
</xs:complexType>
</xs:element>
<xs:element name="layered-modal">
<xs:complexType>
<xs:attribute type="xs:integer" name="height" />
<xs:attribute type="xs:integer" name="width" />
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="theme-properties">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="unbounded" ref="property" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:annotation><xs:documentation>
This element contains all properties dedicate with the theme technology
</xs:documentation></xs:annotation>
<xs:element name="property">
<xs:complexType>
<xs:attribute type="xs:string" name="name" use="required">
<xs:annotation><xs:documentation>
this attribute support the FlexibleMapAccessor syntax
</xs:documentation></xs:annotation>
</xs:attribute>
<xs:attribute type="xs:string" name="value" use="required" />
<xs:attribute type="xs:string" name="type" />
</xs:complexType>
</xs:element>
<xs:element name="templates">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="unbounded" ref="template" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:annotation><xs:documentation>
This element contains all ftl macro template supported by this theme
</xs:documentation></xs:annotation>
<xs:element name="template">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="5" ref="template-file" />
</xs:sequence>
<xs:attribute type="xs:string" name="name" use="required" />
<xs:attribute type="xs:string" name="type" use="required"/>
<xs:attribute type="xs:string" name="encoding" />
<xs:attribute type="xs:string" name="content-type" />
<xs:attribute type="xs:string" name="encoder" />
<xs:attribute name="compress" type="xs:boolean"/>
</xs:complexType>
</xs:element>
<xs:element name="template-file">
<xs:complexType>
<xs:attribute name="widget" use="required" >
<xs:simpleType>
<xs:restriction base="xs:token">
<xs:enumeration value="screen" />
<xs:enumeration value="form" />
<xs:enumeration value="tree" />
<xs:enumeration value="menu" />
<xs:enumeration value="error" />
</xs:restriction>
</xs:simpleType>
</xs:attribute>
<xs:attribute type="xs:string" name="location" use="required"/>
</xs:complexType>
</xs:element>
<xs:element name="common-screens">
<xs:annotation><xs:documentation>
List the location of each common screens that the theme implement
</xs:documentation></xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="0" maxOccurs="1" ref="root-decorator" />
<xs:element minOccurs="0" maxOccurs="1" ref="subtype-decorator" />
<xs:element minOccurs="0" maxOccurs="1" ref="generic-screen" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="common-menus">
<xs:annotation><xs:documentation>
List the location of each common menus that the theme implement
</xs:documentation></xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element ref="root-decorator" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="root-decorator">
<xs:complexType>
<xs:choice>
<xs:element maxOccurs="unbounded" ref="screen"/>
<xs:element maxOccurs="unbounded" ref="menu"/>
</xs:choice>
<xs:attribute type="xs:string" name="default-location" use="optional" />
</xs:complexType>
</xs:element>
<xs:element name="subtype-decorator">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="unbounded" ref="screen" />
</xs:sequence>
<xs:attribute type="xs:string" name="default-location" use="optional" />
</xs:complexType>
</xs:element>
<xs:element name="generic-screen">
<xs:complexType>
<xs:sequence>
<xs:element minOccurs="1" maxOccurs="unbounded" ref="screen" />
</xs:sequence>
<xs:attribute type="xs:string" name="default-location" use="optional" />
</xs:complexType>
</xs:element>
<xs:element name="screen">
<xs:complexType>
<xs:attribute type="xs:string" name="name" use="required"/>
<xs:attribute type="xs:string" name="location" use="optional"/>
</xs:complexType>
</xs:element>
<xs:element name="menu">
<xs:complexType>
<xs:attribute type="xs:string" name="name" use="required"/>
<xs:attribute type="xs:string" name="location" use="optional"/>
</xs:complexType>
</xs:element>
</xs:schema>