11.2.1 Managing Theme Subscriptions

Developers can manage themes using of theme subscriptions.

• About Theme Subscriptions
  Subscribing to a master theme enables the theme to be upgraded during future Oracle Application Express releases.
• About Modifying a Theme Subscription
  Modify a template without breaking the subscription to the master theme by creating a local copy of the template in your workspace.
• Verifying if a Theme Refresh Is Needed
  Use the Verify Theme Subscription Wizard to review all theme attributes, templates, and template options in the subscribing theme and view errors for those that are not in sync with the master theme.
• Refreshing a Subscribed Theme
  Refresh a subscribed theme on the Create/Edit Theme page.
• Unsubscribing to a Theme
  Unsubscribe from a theme to remove the subscription from all templates, styles, files and so on that are part of the theme.
• Re-subscribing to a Built-in Theme
  If a theme is currently unsubscribed, you can return to a subscribed version of this theme.

11.2.1.1 About Theme Subscriptions

Subscribing to a master theme enables the theme to be upgraded during future Oracle Application Express releases.

Developers subscribe to a theme when:

• Running the Create Application Wizard.

  When a developer runs the Create Application Wizard and selects a built-in theme, the theme is automatically subscribed to a master theme. As an alternative to using a built-in theme, the Create Application Wizard provides the option to copy a theme from an existing application. When copying a theme from an existing applications, developers can choose if they wish to have this theme be subscribed to. See "Understanding Page Types, Features, and Settings."

• Creating a new theme from the Theme repository.

  When you create a new theme the associated application automatically subscribes to it. See "Accessing New Themes."

Once an application subscribes to a master theme only the default templates can be changed. All theme attributes, subscribed template options, and subscribed templates are set to read-only. In other words, only the default templates can be changed. The advantage of subscribing to a master theme is that the theme can be upgraded during future Oracle Application Express releases. When a theme is subscribed to, developers cannot modify the theme or template metadata when they access it from the theme or template edit pages.

11.2.1.2 About Modifying a Theme Subscription

Modify a template without breaking the subscription to the master theme by creating a local copy of the template in your workspace.

Local template copies are not subscribed to and are therefore editable. You can take the same approach with theme styles. You can create a local copy of a theme style and then add it to a subscribed theme. Theme styles created locally are editable but will be excluded from theme refreshes.

See Also:

"Copying a Theme"

11.2.1.3 Verifying if a Theme Refresh Is Needed

Use the Verify Theme Subscription Wizard to review all theme attributes, templates, and template options in the subscribing theme and view errors for those that are not in sync with the master theme.

This wizard also highlights any templates that are defined in the master theme but not yet published to the subscribing theme.

To run the Verify Theme Subscription Wizard:

1. Navigate to the Themes page:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Click Shared Components.
   4. Under User Interface, select Themes.
   The Themes page appears. A check mark in the Is Current column indicates which theme is selected.
2. Select the theme.
   The Create/Edit Theme page appears.
3. Locate Theme Subscription and click Verify.
4. Follow the on-screen instructions.
   To publish changes from the master theme to the subscribing theme, click Refresh at the end of the wizard.

11.2.1.4 Refreshing a Subscribed Theme

Refresh a subscribed theme on the Create/Edit Theme page.

To refresh a subscribed theme:

1. Navigate to the Themes page:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Click Shared Components.
   4. Under User Interface, select Themes.
   The Themes page appears. A check mark in the Is Current column indicates which theme is selected.
2. Select the theme.
   The Create/Edit Theme page appears.
3. Locate Theme Subscription and click Refresh Theme.

   Tip:

   If the theme is not subscribed, the Refresh Theme button does not appear. See "Re-subscribing to a Built-in Theme."

4. Click Apply Changes.

11.2.1.5 Unsubscribing to a Theme

Unsubscribe from a theme to remove the subscription from all templates, styles, files and so on that are part of the theme.

Note:

Unsubscribing from a theme prevents future theme updates. Be aware that re-subscribing to a theme is multiple step process that involves copying and switching themes. To learn more, see "Re-subscribing to a Built-in Theme."

To unsubscribe from a theme:

1. Navigate to the Themes page:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Click Shared Components.
   4. Under User Interface, select Themes.
   The Themes page appears. A check mark in the Is Current column indicates which theme is selected.
2. Select the theme.
   The Create/Edit Theme page appears.
3. Under Theme Subscription, click Unsubscribe.
   A warning dialog displays.
4. Click Unsubscribe Theme.

11.2.1.6 Re-subscribing to a Built-in Theme

If a theme is currently unsubscribed, you can return to a subscribed version of this theme.

Re-subscribing to a theme is a multiple step process. First, you change the theme identification number. Second, you run the Create Theme Wizard and create the theme again. Third, you switch the current application to the use the new theme. Fourth, you delete the original theme.

To re-subscribe to a theme.

1. Navigate to the Themes page:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Click Shared Components.
   4. Under User Interface, select Themes.
   The Themes page appears. A check mark in the Is Current column indicates which theme is selected.
2. From the Tasks list, select Change Identification Number and change the theme to a new identification number. See "Changing a Theme Identification Number."
3. Run the Create Theme Wizard and create the theme again. See "Accessing New Themes."
4. Switch the current application to the use the new theme. See "Switching Themes."
5. Delete the original theme from which you created a new identification number. See "Deleting a Theme."