August 2013 Release Highlights

Agility CMS
Agility CMS
Sep 5, 2013

Sync Updates

  • Full Sync is no longer triggered if the Domain object is not found.
  • Sync Status (in Reports) now will show content items as "In Progress" until all items have been copied down to local content files.
  • Various updates to how webservers within Azure copy files between their instances, the content server and blog storage.
  • Improved error logging on sync errors in Azure when an instance is down.
  • Improved start up procedures in Azure when an instance is rebooting.
  • Empty Content Views are no longer synchronized.

Social Publishing

You can now publish new content directly to your Facebook, Twitter and LinkedIn accounts.

Social publishing can be setup for any content definition and will be shared when you first publish your content item. Note that it will only be shared when you first publish your content item. Changing an existing content item and then publishing it again will not trigger another share event.

Additionally, any existing content items will not receive the Social Media Share settings and would need to be setup manually. Social Media Share settings will only be applied to new content items.

There are three general steps to setting up Social Publishing:

  1. Create/Register your Social Media App(s).
  2. Define your Social Media App(s) within Agility.
  3. Add your Social Media App(s) to a content definition and configure the properties to be shared.

Creating a Facebook App for Agility Social Publishing:

  1. Log into your Facebook account and navigate to
  2. Click Create New App.
  3. Choose an App Name (ie. "ABC Agility Social Publish").
  4. Leave App Namespace blank, set App Category to Other, and leave the Web Hosting field unchecked.
  5. Click Continue.
  6. Next, you will be shown an expanded view of the properties of your App.
  7. Ensure you set the AppDomains field to ""

  8. Ensure the Sandbox Mode is set to "Disabled," or OFF.
  9. Ensure the Website with Facebook Login field is checked and set the Site URL field to "".
  10. Click Save Changes to complete your App registration and configuration.
  11. Next, record the App ID and App Secret values,you will need these in order to define your App in Agility.

Creating a Twitter App for Agility Social Publishing:

  1. Log into your Twitter account and navigate to
  2. Click Create a new application.
  3. Set a Name for your app (ie. "ABC Agility Social Publish").
  4. Set a Description for your app (ie. "Social Publish app for Agility CMS").
  5. Under Website use ""
  6. Under Callback URL use ""
  7. Click Create your Twitter application (you may need to fill in a Captcha).
  8. Record the Consumer Key and Consumer Secret of your app ? you will need this to define your app in Agility.
  9. Click on the Settings tab, and ensure that "Read and Write" is selected under "Application Type."
  10. Save the application.

Creating a LinkedIn App for Agility Social Publishing:

  1. Log into your Twitter account and navigate to
  2. At the top right, hover over your name, and click on "API Keys" from the dropdown menu.
  3. Click on "Add New Application."
  4. Choose the name of the Company you wish to associate the application with.  This will be the account's feed where all shared items will appear.
  5. Fill in all of the required information and then click on "Add Application" . *** Be sure to note whether your application is to be run in Live or Development mode.
  6. After you add the application, your API Key and Secret Key will appear under the "OAuth Keys" section.  You can Regenerate or Revoke these keys whenever you wish.

Defining your Social Media App in Agility:

    • Log into Agility and navigate to Settings.
    • Under Configuration, select Social Media Accounts.
    • Click New Item to create a new definition.

    • Select your Platform (ie. Facebook, or Twitter, or LinkedIn).
    • Give your app a Display Name (ie. "Facebook").
    • Enter your app Account/API Key.
    • Enter your app Account Secret.
    • Click Connect to {Name of Platform Chosen}, this will prompt a new window and ask to confirm permission to use the app.
    • Confirm status is "Connected to [social media platform name]", if not try looking at your App Settings to ensure the domain and website URLs are set correctly.
    • For Facebook or LinkedIn, once connected you will see an option below to "Publish to page". This option is used to publish to FB or LinkedIn PAGES rather than individual user profiles
      NOTE: You MUST be an admin of the Facebook or LinkedIn Company page you wish to publish to in order to set up the publish to page option

    • Click Ok to close the dialogue.

Adding Social Publishing to your Content Definition:

      1. Log in to Agility and navigate to Settings.
      2. Under Customization, select Content Definitions.
      3. Search the list of definitions for your desired list and click its name to open the content definition properties.
      4. Click the Default Sharing tab.
      5. Click New Item to add a Social Media App.
      6. Choose your Account. This will be a list of your defined Social Media Accounts.
      7. Choose your Language, this allows you to setup multiple share templates based on language.
      8. Set a Title by clicking + Add Field, this will allow you to add a content item's property to be used as the Title or part of the Title.
      9. Set a Body Formula by clicking + Add Field, this will allow you to add a content item's property to be as the Body or part of the Body.
      10. Set a URL by clicking + Add Field, this will allow you to add a content item's property to be as the URL or part of the URL.
      11. Set an Image Formula by clicking + Add Field, this will allow you to add a content item's property to be as the Image Formula or part of the Image Formula.
      12. Optionally set a Start Time to specify when to share the content item on its published day. For example, one could set a Start Time to 6:00pm which would mean that if the content item was published before 6:00pm that day, then the share event would not happen until 6:00pm that day.
      13. Click Ok when you are satisfied.
      14. Click Save on the content definition.
      15. Now, when a content item which is based on this content definition is first published, it will be shared automatically to one or more of your Social Media Accounts (unless you have a Start Time set to later today). NOTE:  the share event is only fired when your content item is first published, changing a content item which is already published and publishing it again will not send another share event.

Disabling Social Publishing on specific Content Items:

It's important to understand exactly how Social Publishing works on each content item of a content definition. There may be some cases where you do not want your published item to be shared via your Social Media Accounts.

Common Cases:

      • Importing Content via the Content Import API or by CSV file
      • A new content item or multiple content items which you simply don't want to share

In order for a content item to be shared on publish, it needs to have a valid list of Social Media Share Items. Once Social Media Share Definitions have been added to the content definition, each new content item created (using the same content definition) after will have these settings copied directly to the content item. Understanding this allows us to effectively control sharing on each individual content item. 

There are two ways to disable sharing on content items:

      1. Before you publish your content item, navigate to the "Sharing" tab within content item input form.

        Then, select the Social Media Sharing Item(s) (these are based from your Social Media Share Definitions) you would like to disable by checking their corresponding checkbox and clicking Disable. This will ensure the current content item does not get shared on publish.

      1. Because we know that our Social Media Sharing Items are copied directly from what is set in the content definition when a new content item is created, we can plan ahead and save us from having to manually go into each content item and disabling Social Media Share Items. You can simply set the Social Media Share Definitions in the content definition to Disabled temporarily while you create/import your content items. These Disabled settings will then be copied to your new content items. Afterwards, you can re-enable your Social Media Share Definitions so that any new content items will once again receive enabled Social Media Sharing Items.

Image Galleries

Agility Image Galleries have been improved to allow "New" Image Galleries via a content or module definition. This allows content editors to create new Image Galleries directly from the content item/module, similar to how linked content views are handled.

Other Improvements:

      • Description for an image within an Image Gallery is now an HTML type
      • Upload directly to an Image Gallery without having to first upload to Media & Documents

Adding an Image Gallery Field to a Content Item/Module:

      1. Log into Agility and navigate to Settings.
      2. Select Module Definitions or Content Definitions.
      3. Select a Module or Content Definition from the list.
      4. In the Form Builder tab, click Add Field.
      5. Set your Field Label, Field Name, and change the Field Type to 'Image Gallery."
      6. You know have 3 options to choose for the field Image Gallery
        • "New Gallery" - selecting this will display a Thumbnails tab and allow you to configure a list of default thumbnails to create when the Image Gallery is attached to a new content item/module.

          The corresponding UI will display its own newly created Image Gallery control within the content item/module input form. The Image Gallery will automatically be stored in a nested folder structure like: {ReferenceName}/{FieldName}/{Title}-{RandomString}.

        • "User Selectable," with this option selected the content editor will be allowed to choose an Image Gallery from all available Image Galleries directly from the content item/module. The below figure represents the input form control rendered.

        • "Existing Gallery" allows you to permanently set which Image Gallery the module/content item will use.

          The Existing Image Gallery input form control will render the existing Image Gallery.

Uploading Images directly to an Image Gallery:

You can upload directly to an Image Gallery by either finding the Image Gallery within Media & Documents or by navigating directly to your module/content item input form which has a field of type "Image Gallery."

    1. Log in to Agility and navigate to Media & Documents and click on the Image Galleries tab and select your Image Gallery from the list.


      Log in to Agility and navigate to a module/content item which has a field type of "Image Gallery" and ensure an Image Gallery is selected.

    2. Click Upload. This will launch a window to allow you to select an image from your local computer.

    3. You may select a single image, multiple images (CTRL + Left-Click on Windows), or entire Zip files which can contain numerous images.

Back to All Articles

Our Latest Posts