| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| <html lang="en"> |
| <head> |
| <meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2011. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." > |
| <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
| <meta http-equiv="Content-Style-Type" content="text/css"> |
| <link rel="STYLESHEET" href="../book.css" charset="ISO-8859-1" type="text/css"> |
| <script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js" type="text/javascript"></script> |
| <title>Adding the preference page</title> |
| </head> |
| <body> |
| |
| <h2>Adding the preference page</h2> |
| |
| <p> |
| The combination of product properties and default preference values can fully |
| configure the Universal Welcome if no further customization is desired. For |
| products that want to allow users to customize Welcome, a preference page is |
| available. The following code should be added to the product's plugin.xml: |
| </p> |
| |
| <pre> |
| <extension |
| point="org.eclipse.ui.preferencePages"> |
| <page |
| category="org.eclipse.ui.preferencePages.Workbench" |
| class="org.eclipse.ui.intro.universal.ExtensionFactory:welcomeCustomization" |
| id="com.example.intro.introCustomization" |
| name="%introCustomizationPreference.name"> |
| <keywordReference id="org.eclipse.ui.ide.appearance"/> |
| </page> |
| </extension> |
| </pre> |
| |
| <p> |
| This code will add the Welcome customization preference page. The page allows users |
| to select the presentation theme. The original choice is provided by the theme |
| preference in the plugin_customization.ini file. In addition, users can choose from |
| the list of available root pages. Checking the root page causes the related tab to |
| appear at the top of the dialog. |
| </p> |
| |
| <p> |
| When saved, this preference page will prefix the variables with |
| the product id so that it does not interfere with the settings made for other |
| products in the same workbench. Alternatively, selecting the checkbox above will |
| not prefix the variables, making the stored settings visible to all the |
| products. |
| </p> |
| |
| </body> |
| </html> |