Plug-in Content Wizards
Identifier:
org.eclipse.pde.ui.pluginContent
Description:
This extension point provides for contributing wizards that create additional content of the PDE plug-in
projects. After the plug-in manifest and key files have been
created, these wizards can be used to add more files and
extensions to the initial structure. A typical implementation
of this wizard would add content based on a parametrized
template customized based on the user choices in the wizard.
The goal is to arrive at a plug-in that is does something
useful right after the creation (e.g. contributes a view,
an editor etc.).
Configuration Markup:
<!ELEMENT extension (
wizard*)>
<!ATTLIST extension
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED
>
-
point - a fully qualified identifier of the target extension point
-
id - an optional identifier of the extension instance
-
name - an optional name of the extension instance
<!ELEMENT wizard (
description?)>
<!ATTLIST wizard
id CDATA #REQUIRED
name CDATA #REQUIRED
icon CDATA #IMPLIED
class CDATA #REQUIRED
category CDATA #IMPLIED
ui-content (true | false) "true"
java (true | false) "true"
rcp (true | false) "false"
pureOSGi (true | false) "false"
requiresActivator (true | false) "false"
>
-
id - a unique name that will be used to identify this wizard.
-
name - a translatable name that will be used in UI representation
of this wizard.
-
icon - a relative path of an icon that will be used to visually
represent the wizard.
-
class - a fully qualified name of a class which implements
org.eclipse.pde.ui.IPluginContentWizard.
-
category - an optional tag that can be used to associate content wizards with different target projects.
-
ui-content - a flag that indicates if the wizard will contribute code with user interface content. This flag will affect which plug-in class will be picked since (UI plug-ins extend
AbstractUIPlugin class, while non-UI plug-ins extends Plugin base class). Since many contributions to Eclipse have UI content, this attribute is true by default.
-
java - a flag that indicates that the wizard will contribute Java content. Since most of the Eclipse plug-ins have Java code, the attribute is
true by default. Set it to false if the plug-in will not have Java code (for example, documentation files only).
-
rcp - Since 3.1. A boolean flag indicating whether the wizard contributes a standalone fully-functioning rich client application. If set to
true, the wizard will appear in the New Plug-in Project wizard only when the user chooses the Rich Client Application option.
-
pureOSGi - Since 3.2. A boolean flag indicating whether the wizard contributes a pure OSGi bundle. If set to
true, the wizard will appear in the New Plug-in Project wizard only when the user chooses to create a pure OSGi bundle.
-
requiresActivator - Since 3.2. A boolean flag indicating whether the wizard contributes an activator class. If set to
true, the wizard will appear in the New Plug-in Project wizard only when the user chooses to generate an activator to control the plug-in life cycle.
<!ELEMENT description (#PCDATA)>
Short description of this wizard.
Examples:
The following is an example of this extension point:
<extension point=
"org.eclipse.pde.ui.pluginContent"
>
<wizard
name=
"Example Plug-in Content Generator"
icon=
"icons/content_wizard.gif"
class=
"com.example.xyz.ContentGeneratorWizard"
id=
"com.example.xyz.ExampleContentGenerator"
>
<description>
Adds a view and a preference page.
</description>
</wizard>
</extension>
Supplied Implementation:
PDE provides APIs for contributing content wizards based on customizable templates. A number of concrete wizards based on these templates is contributed by PDE UI itself.
Copyright (c) 2004 IBM Corporation and others.
All rights reserved. This program and the accompanying materials are made
available under the terms of the Eclipse Public License v1.0 which
accompanies this distribution, and is available at
https://www.eclipse.org/legal/epl-v10.html.
