Welcome, Guest Login

Support Center

Our documentation is moving:

Please check for the most up-to-date LiveWhale CMS and LiveWhale Calendar documentation. The below legacy documentation will remain available as a reference until the documentation migration is complete.

Global Widgets

Last Updated: Jun 30, 2016 12:25PM PDT

Globals are system-wide settings for content that is automatically available to any LiveWhale user in any group.

Shared widgets allow you to create aggregated forms of content that are available to all, and can dictate certain styles and structure which you maintain. The best thing about shared widgets is when they are combined with group=me, they automatically inherit the local group’s content.

LiveWhale content editors can drop in Global Widgets onto their page very easily with no effort. But sometimes the global widget will only get you 95% there. Maybe you want to tweak it slightly to grab something more specific. No problem, below I'll show you how to add a global widget and what to do if you want to tailor it to your needs.

Adding a Global Widget

1. Go to your page and click Edit Page
2. Click into the section where you want to add your global widget to reveal the WYSIWYG editor.
3. Click the '+' button and select Widget

4. A panel will appear to select an existing widget. Notice the widgets with a globe icon are your global widgets that have been shared with you. Select one of these widgets to drop into your page.

5. Click the Insert button to drop the widget in place and save your page to publish your change

Extending a Global Widget

If you have inserted a Global Widget, but it's not doing that 5% extra that you need it to do, you can update it from the page. For example, perhaps you want only the stories tagged, "biology". Here's how to do it:

1. Go to the page and click Edit Page
2. Click on the editable region where your global widget is located to reveal the WYSIWYG editor.
3. Click the source code < > icon to reveal the html code
4. Find the global widget in the html code 

5. You can pass arguments inside your <widget> code in the html source like this: 
<widget id="40_news_homepage_stories">
  <arg id="tag">biology</arg> 

6. In the code, we passed an argument requesting that we're only interested in stories tagged 'biology'
7. When you are done editing the code click the OK button and save your page to publish your change

 Tips & Tricks

1. There are many arguments that you can use to pass to widgets. Check out all the available arguments here

2. If you are having a difficult time with the syntax, you can use the widget editor for assistance in writing the code. Fill in the criteria in the widget form and watch the widget syntax window for the arguments to pass into your html code.
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found