Share via


WebTemplate Element (Web Template)

Applies to: SharePoint Foundation 2010

Configures several aspects of a custom web template and the websites that are created from it. This element is in an elements.xml file that is inside the .wsp file that packages a web template.

Elements (Web Template)
  WebTemplate Element (Web Template)

<WebTemplate ... />

Complex

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute

Type

Description

AdjustHijriDays

int

Optional. Specifies the number of days to extend or reduce the current month in Hijri calendars that are used on websites that are created from the web template.

AlternateCssUrl

string

Optional. Specifies the URL for an alternative cascading style sheet (CSS) to use for the websites that are created from the web template.

AlternateHeader

string

Optional. Specifies the name of an ASPX page that is located in the %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS directory that defines an alternative header for the top area in site pages of websites that are created from the web template. This attribute provides a way to replace the header region with the output of an ASPX page that defines a different header. For example, to specify myHeader.aspx as the name of the file that provides an alternative header, add AlternateHeader="myHeader.aspx" to the Project element at the beginning of the Onet.xml file.

BaseTemplateID

int

Required. The ID of the site definition on which the web template ultimately derives. This is the value of the ID attribute of the Template element in a WebTemp*.xml file.

BaseTemplateName

string

Required. The internal name of the site definition on which the web template ultimately derives. This is the value of the Name attribute of the Template element in a WebTemp*.xml file.

BaseConfigurationID

int

Required. The ID of the site definition configuration on which the web template ultimately derives. This is the value of the ID attribute of a Configuration element in a WebTemp*.xml file.

CalendarType

int

Optional. The ID of the default calendar type for calendars on websites that are created from the web template.

Collation

int

Optional. The ID of the collation system for websites that are created from the web template. For more information, see Collation.

ContainsDefaultLists

boolean

Optional. Specifies whether the site definition from which the web template is ultimately derived contained lists that are defined in the global Onet.xml file. This is significant because if the original site definition did contain such lists, those lists are not included in websites that are created from the web template.

CustomizedCssFiles

string

Optional. Specifies custom cascading style sheet (.css) files.

CustomJSUrl

string

Optional. Specifies a custom JavaScript file located in the %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS directory that contains script to execute within a website created from the web template.

Description

string

Optional. A description of the site type that is defined by the web template as it appears in the user interface (UI) when users are selecting a type of website to create.

DisplayCategory

string

Optional. Specifies the category in which the web template appears in the Microsoft SharePoint Foundation UI when users are selecting a type of website to create; for example, Collaboration, Meetings, or some other custom name. If it is not specified, the default is "Custom".

ExcludeFromOfflineClient

boolean

Optional. Specifies whether websites that are created from the web template are downloaded during offline synchronization.

ImageUrl

RelativeUrl

Optional. Contains the URL for the preview image that is displayed in the SharePoint Foundation UI when users are selecting a type of website to create.

Locale

int

Optional. The numeric ID of a language/culture, such as 1033 for U.S. English.

Name

string

Required. The internal name of the web template.

ParserEnabled

boolean

Optional. Specifies whether column values in document libraries are automatically added to documents that are added to a library in websites that are created from the web template.

PortalName

string

Optional. The name of the portal site that is associated with websites that are created from the web template.

PortalUrl

string

Optional. The URL of the portal site that is associated with websites that are created from the web template.

PresenceEnabled

boolean

Optional. Specifies whether inline presence information for users is enabled on websites that are created from the web template.

ProductVersion

int

Optional. The version of SharePoint Foundation in which the web template is created.

QuickLaunchEnabled

boolean

Optional. Specifies whether there is a Quick Launch area on websites that are created from the web template.

Subweb

boolean

Optional. Specifies whether the web template was created from a subweb or the root website of a site collection. If it is True, the template was created from a subweb.

SyndicationEnabled

boolean

Optional. Specifies whether Really Simple Syndication (RSS) is enabled for websites that are created from the web template.

Time24

boolean

Optional. Specifies whether to use a 24-hour time format to represent the hours of the day on websites that are created from the web template.

TimeZone

int

Optional. The default time zone of websites that are created from the web template.

Title

string

Optional. The public name of the web template.

TreeViewEnabled

string

Optional. Specifies whether the tree view feature is enabled in the left navigational area of pages in websites that are created from the web template. Although this attribute is type string, the only meaningful values are "TRUE" and "FALSE".

UIVersionConfigurationEnabled

boolean

Optional. Specifies whether users can change the UI version of websites that are created from the web template.

Child Elements

None

Parent Elements

Elements (Web Template)

Example

The following includes an example of a WebTemplate element.

<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <WebTemplate 
    AdjustHijriDays="0" 
    AlternateCssUrl="" 
    AlternateHeader="" 
    BaseTemplateID="9" 
    BaseTemplateName="BLOG" 
    BaseConfigurationID="0" 
    CalendarType="1" 
    Collation="25" 
    ContainsDefaultLists="TRUE" 
    CustomizedCssFiles="" 
    CustomJSUrl="" 
    Description="A 4th Generation Blog Site." 
    ExcludeFromOfflineClient="FALSE" 
    Locale="1033" 
    Name="BlogIV" 
    ParserEnabled="TRUE" 
    PortalName="" 
    PortalUrl="" 
    PresenceEnabled="TRUE" 
    ProductVersion="4" 
    QuickLaunchEnabled="TRUE" 
    Subweb="TRUE" 
    SyndicationEnabled="TRUE" 
    Time24="FALSE" 
    TimeZone="13" 
    Title="Our Blog" 
    TreeViewEnabled="FALSE" 
    UIVersionConfigurationEnabled="FALSE" />
</Elements>

See Also

Concepts

Site Types: WebTemplates and Site Definitions