XHTML Editor Custom Content CSS Files


Prerequisites:
  • The importcss plugin must be selected for all applicable default and group options in Administration > System Options > CMS > XHTML Editor > Plugins. See XHTML Editor Plugin Selection for details about applying plugins.
    Caution
    Selecting this plugin overrides the default Format options of the XHTML editor.
  • The custom CSS files must be created in one of the following locations:
    • The systems administrator must 1) create the custom CSS file(s) that contains all XHTML editor classes and styling, and 2) save the CSS file(s) in [Drive]:[path-to-CMS-root-folder]\App_Data\XML.
    • The administrator must 1) create the custom CSS file(s) that contains all XHTML editor classes and styling, and 2) save the CSS file in the CMS Assets Manager.

With administrator permissions, you can provide custom CSS classes within CSS files to customize XHTML editor formats. Specify the CSS file(s) by default or on a "per group" basis.

To set the location of the custom content CSS file:
  1. Navigate to Administration > System Options > CMS > XHTML Editor > Custom CSS.

    XHTML Editor Custom CSS Configuration

  2. Choose one of the following steps:
    • Click the Default option to modify configurations for all users.
    • Click the Group option to modify configurations for a particular user group. Choose the group from the Selected Group drop-down list.

      Version Notes: CMS 10.6 vs. CMS 10.0–10.5
      • Groups with checkmarks ✓ in the list have custom configurations.
      • If you modify configurations for the Default option and the per individual Group option, each group's configurations automatically overtake the Default option for applicable users.

      • If you want to delete configurations from a particular group, complete the step that corresponds with your CMS version:
        • For CMS 10.6: Clear the checkbox next to the group, then click Yes in the Restore Defaults dialog that displays.

          CMS 10.6 Restore Defaults

        • CMS 10.0–10.5: Hover over the checkbox next to the group, then click the Restore Defaults minus (-) icon.

          CMS 10.0–10.5 Restore Defaults

  3. Enter the CSS file's relative path or asset ID in the CSS File Path field.
    Additional Information

    • The custom CSS file can live in [Drive]:[path-to-CMS-root-folder]\App_Data\XML via the CMS file system or in the Assets Tree via the CMS user interface.

      If you specify the file location in the CMS file system, the field requires the filepath to be relative to the XML folder. Only system administrators can access the CMS file system.

    • If you specify the file location in the Assets Tree, the field requires the asset ID (a/ID). Users with permissions can access the CSS file.

    Caution
    If you plan to make configuration changes for more than one user group, ensure you save your changes before switching between groups. If you switch from one to another without saving, you will lose your changes.
  4. Click Save.
    The CMS implements styling to XHTML editor formats with classes identified in the CSS file.

Next Steps:

Choose one of the following optional steps.