For Developers
Support for our UBCMS developers.
On this page:
Flex UI is available to all UBCMS users now. Learn more.
Pardon the Dust
Sorry, gang, for an awkward page. It's currently a quick dumping place for what we feel may be useful tips.
Last reviewed: January 21, 2022
Akamai content delivery network
The Akamai content delivery network (CDN) delivers our Web pages through high-speed 'edge' servers physically located around the globe, instead of through the 'origin' servers directly (our UBCMS servers). The CDN helps accelerate, filter, and secure web traffic.
Author Debugging Tools
Some of these tools are only available in Flex UI.
no custom
- This trick is good for debugging page problems in live sites and Author.
- Simply add "?nocustom=1" to the end of the URL in the browser location bar to turn off any custom code that is not normally part of the UBCMS which may be interfering with page behavior.
- e.g. compare https://www.buffalo.edu and https://www.buffalo.edu?nocustom=1
- nocustom temporarily suppresses:
- HTML snippets
- External embeds
- “Head HTML” from page properties
- Custom HTML from design properties
- main.css and main.js from design folders
- Google Tag Manager
- Shared Content Reference components directly including CSS or JS files
- “customize” nodes
rescue mode
- This trick is good for debugging and fixing page problems in the Author environment.
- It reduces the page to a skeleton view, so it is easy to find all the components including any that are hidden. Components can be modified normally, or temporarily turned off, before the page is then re-displayed. Simply add "?rescuemode=1" to the end of the URL in the browser location bar.
- e.g. https://ubcms-author.buffalo.edu/content/your-domain/your-site.html?rescuemode=1 (login required)
- This does not disable all CSS but renders most components in a data-only way which can block the effects of misbehaving components that might mess up the whole page. It can also reveal empty or invisible components that cannot otherwise be edited or deleted.
wcm mode
- This trick allows you to preview a page in Author as if it were published live.
- Temporarily disable most of the author environment on a page, including the Sidekick, by adding '?wcmmode=disabled' to your page’s URL in the browser location bar.
- e.g. https://ubcms-author.buffalo.edu/content/www/cmshelp.html?wcmmode=disabled (login required)
CRXDE
location of CRXDE off the Start page
The link to CRXDE is off the Start page. Look on the left for the Tools hammer icon. Click that to reveal 'General'. Click that to reveal the link to CRXDE (developers only).
Tag Admin Console
location of Tag Admin Console off the Start page
The link to the Tag Admin Console is off the Start page. Look on the left for the Tools hammer icon. Click that to reveal 'General'. Click that to reveal the link to Tags (admins only).
User Admin / Group Manager
location of User and Group Manager admin tools off the Start page
The links to the User Admin and Group Manager Tools are off the Start page. Look on the left for the Tools hammer icon. Click that to reveal Security. Click that to reveal the link to both user tools (admins only).
Emulator / Mobile Device Simulator
Display your page as it would appear in mobile phones and other size devices.
Copy Content to Another Page
You can copy and paste content from one browser tab to another.
Compare Pages (DIFF)
Compare two versions of a page, usually the current with the last published.
Compare Two Different Pages
Use this trick to compare two different pages side by side in one window. It's similar to the Diff tool, but for any pages you specify, and without markup.
details
This example compares two university news releases in from shared content: https://ubcms-author.buffalo.edu/mnt/overlay/wcm/core/content/sites/diffresources.html/content/shared/university/news/news-center-releases/2021/01/001?item=/content/shared/university/news/news-center-releases/2021/01/003&sideBySide
Replace the URL fragments manually:
https://ubcms-author.buffalo.edu/mnt/overlay/wcm/core/content/sites/diffresources.html +
/content/shared/university/news/news-center-releases/2021/01/001
+ ?item=
/content/shared/university/news/news-center-releases/2021/01/003
+ &sideBySide
Page Load Speed
Why We Care
- user retention, especially mobile
- SEO, especially Google
- first page load is more important than it used to be; e.g. clicking a search result, ad, email campaign link
- browser cache is no help here
How We Measure...
- Core Web Vitals (LCP, FID, CLS) - https://web.dev/vitals
- green (90-100) is unrealistic for mobile but commonf or desktop
- yellow (50-89) most pages will be in this range on mobile
- red (0-49) our pages shouldn't scor ethis low without a large external script or iframe but Google expects the average to be 50 so half of pages in general will be in this range including our many of our peers
- “Lab” Measurements - force a measurement
- Google PageSpeed Insights - https://pagespeed.web.dev
- Lighthouse - in Chrome DevTools and elsewhere - https://developers.google.com/web/tools/lighthouse
- Web Vitals Chrome extension - https://chrome.google.com/webstore/detail/web-vitals/ahfhijdlegdabablpippeagghigmibma
- “Field” Measurements - log what real users actually experience
- Chrome User Experience Report - https://developers.google.com/web/tools/chrome-user-experience-report
- Google Search Console Core Web Vitals Report - https://support.google.com/webmasters/answer/9205520
What Matters...
- Mobile devices
- mobile processor speeds are slow
- mobile network conditions are slow and unreliable
- Fonts
- Javascript, especially at the top of the page
- Third-party embeds (scripts, iframes)
- Duplicate or unnecessary analytics tags
What Doesn't Matter (as much)...
- desktops/laptops typically fast and well-connected
- images (somewhat, but we optimize for you)
- off the screen / below the fold - does not contribute to LCP
- video - does not contribute to LCP
- background images - does not contribute to LCP
What You Can Do...
- consider the impact of everything you put on each page (cost/benefit)
- think even harder about what you put on every page (header, footer)
- watch for scripts, iframes, tags in GTM
- move slow things lower down the page / below the fold
- turn heavier analytics off when not needed (e.g. heat tracking)
- measure and test
Learn More, Including What We're Doing For You