Because of the decoupled nature of Omni CMS, elements that exist only on the live website server don't appear on Omni CMS pages on staging. This means that server-side code elements, such as news and events feeds, some types of navigation, or course and program lists, don't appear in Preview or Edit mode of a page.
If you embed a YouTube video on a page by taking the embed code YouTube provides and pasting it into the source code of a page, you might encounter an error where the page cannot be edited. This is caused by the default YouTube embed code being empty between the
</iframe> elements, which causes errors in Omni CMS.
The recommended course of action for embedding videos is to do it through Omni CMS' Insert/Edit Media tool in the WYSIWYG editor by pasting in the URL of the video. However, if you are using the embed code provided by YouTube, it can be fixed by adding an
</iframe> elements. Or alternatively, add in a comment. The value in between the starting and closing
<iframe> elements prevents an empty iframe, which is what caused the error initially.
I replaced one image with another, but now the image appears stretched or squashed.
The new image is taking on the dimensions of the old one. To resolve the issue, try one or more of the following:
- Edit the image
- Click the image.
- Click the Insert/Edit Image button in the WYSIWYG toolbar.
- Delete specified dimensions.
- Click Save.
- Clear your cache or do a hard refresh of the page.
- Re-select the image via the "Insert/Edit Image" file chooser.
If all else fails, delete the original image and re-add it to the page.
Most modern web browsers block copy/paste abilities in toolbars. Use keyboard shortcuts instead.
Administrators can create custom toolbars that limit which editing options are available, and assign these toolbars to users and folders. Some file and content types also use a pared-down toolbar.
Most users don't have permission to edit page source code. Users levels 1 through 8 can be granted permission, but it is turned off by default in their user settings. The page must also be checked out for the source code option to appear.
Props files exist on a per-section basis and handle a variety of settings for the section, depending on how they were implemented: everything from breadcrumb titles or other content to potentially color schemes.
If you encounter this error message, it is because the page or file is trying pull a value from a
_props.pcf file that it cannot locate, whether because the file has been renamed, moved, deleted, or not published yet. To solve the problem, try:
- Publishing the
_props.pcffile in the folder, if it exists.
- If it does not, create a new one. The easiest way to do this is by creating a new section,
- Navigate to Content > Pages.
- Click +New.
- Select the appropriate template for a new section.
- A props file should automatically be generated.
- Move it into the folder that is missing the props file.
- Delete the section you just created.
- If this still doesn't work, you may need to do some digging in your XSL to find out how and where the
_props.pcffile is being pulled in. Reference the developer notes for your implementation, or reach out to our team for additional help.
There's an error with the source code of the page that prevents Omni CMS from rendering it. Check the error message for the type and location of the problem.
When inserting a link onto a page, you might want to link to a page that you don't have access to in Omni CMS. This can be circumvented by linking to the page on the live website (production server), rather than staging.
While choosing a file to link to, in the upper right-hand corner of the filechooser box, use the dropdown to switch from "Staging" to "Production."
Locate the file that you want to link to, and proceed as normal.
Links chosen in this way are still managed via dependency manager, should that be on for your account.
When a file is restored, it generates a new dependency tag and any links pointing to the old tag must be updated.
If you were editing page content in an editable region, use the Restore Last Draft icon to restore content lost up to twenty minutes ago.
Alternatively, if the tab you were working in is still up, open the same Omni CMS site in another tab and log in there. Your credentials cover the first tab as well, and you can save your work and continue editing as normal.