• .Net error when using getList methods
    DescriptionWhen using a getList method in Ektron 9.10, you may get an error:  The parameter data type of UInt32 is invalid.  This error occurs by passing a long value directly to a criteria object. For example: criteria.AddFilter(TaxonomyProperty.Id, CriteriaFilterOperator.EqualTo, 2147484121); ...

  • Add a collapse option for the Ektron Toolbar
    DescriptionWith the current Ektron Toolbar, when editing a page builder page, there is no way to collapse/hide the toolbar from view. This can be problematic if you have a content item that needs to be edited that abuts the top of the page. The code sample below shows how to add an option to all...

  • Add Language to Metadata Definition using MetadataTypeManager
    DescriptionThis article provides a sample that will take an existing metadata definition and add it into the CMS with a new language. ResolutionCode Download* Note - This sample uses the MessageUtilities. Please refer to this KB for more information. Code files included.

  • Add New Language For Existing Content With ContentManager
    Description This article shows a sample and describes the steps to leverage the ContentManager to programmatically add new language versions of content for existing content items in the CMS retaining the same ID. Resolution 1. Call the ContentManager.GetItem to pull the existing c...

  • Adding a user data object with required and custom properties to the CMS
    DescriptionIt is a simple task to add users to Ektron via the Ektron Framework API.When entering any user data object into Ektron, you need to complete two types of properties. Below is an example of a user data object for a membership user that has the required properties and customer propertie...

  • Basic Captcha Example using the Ektron Server Controls
    DescriptionEktron has built in captcha support right out of the box. Here is an example of how you could implement it on a template. Resolution<%@ Page Language="C#" %><%@ Register Assembly="Ektron.Cms.Framework.UI.Controls" Namespace="Ektron.Cms.Framework....

  • Best Practices for Service Authentication
    DescriptionWhen using the Ektron Restful Services and Web Services, an authentication method, such as an authentication header or token, is required. Once a user is authenticated, he or she is usually authorized to access desired resources/APIs. For more information on authentication methods, se...

  • Caching: Why it is beneficial and ways to implement it
    DescriptionThis article introduces basic caching concepts and Ektron's caching options.Caching enables you to store data in memory for rapid access. Applications can access the cache instead of retrieving data from the database whenever the data is accessed. This strategy avoids repeated queries...

  • Content Manager Add Content not submitting for approval
    DescriptionContent Manager Add Content not submitting for approval ResolutioncontentManager.Add(contentdata);contentdata = contentmanager.GetItem(contentdata.Id); You should now be able to do what you need to with contentdata object.See also Ektron Developer Reference > Framewo...

  • ContentManager.GetList(ContentCriteria) -SQL Exception Invalid column name 'nav_name'."
    SQL Exception Invalid column name 'nav_name'." is an error in the API for ContentManager.GetList It occurs commonly if customers use the ContentTypeManager  GetList(ContentCollectionCriteria criteria) public List<ContentType<T>> GetList(ContentCriteria criteria) { ...

  • Customizing eCommerce Checkout Server Control with Phase Change Sample
    DescriptionThis article contains information and a sample on manipulating Ektron Checkout Commerce control phases as described in the documentation.ResolutionCode Download The eCommerce server controls contain event hooks so you can customize or manipulate them. To use these event hooks, creat...

  • Ektron CMS Strategy Samples
    DescriptionThis sample is to provide a quick method of deployment for the Ektron CMS strategies. The sample contains the follow strategies: Blog Strategy Content Strategy Library Strategy Taxonomy Strategy User Strategy ResolutionHow to set up these files: Place the strategy class files for th...

  • Ektron.Cms.UrlAliasing.ICommonAliasManager, is an interface and cannot be constructed
    This error can occur if the code is using legacy alias APIs that existed in 8.5 Ektron versions and an upgrade was conducted to push it to 8.60. For a complete list of UrlAliasing Framework API, click here. Legacy Ektron.Cms.Framework.Settings.UrlAliasing APIs include the following: Au...

  • EktronUI: Dialog Button OnClick Event Causes Full Post Back
    With the EktronUI Dialog control in ContentTemplate tag of ASP UpdatePanel, the Dialog Button's OnClick event causes a full post back. Resolution Because of a z-index problem with IE7, the dialog is moved to be an immediate child of the form. In the process, the dialog is...

  • Error updating taxonomy data when using the Taxonomy Manger GetItem
    When using the framework API GetItem method for the TaxonomyManager you may get an error when trying to update the taxonomy data back into the system. Below is the error and a sample of code that could cause the error. Ektron.Cms.Framework.Organization.TaxonomyManager tManager = new Ekt...

  • Error: Could not create type 'Ektron.Seesmic.SeesmicService'
    When trying to compile/build your 9.02Sp2 website, you're seeing the following error message: Could not create type 'Ektron.Seesmic.SeesmicService'. Resolution Thankfully this is a pretty simple error to correct. The issue lies with a webservice file in the workarea call...

  • Examining the Object Factory
    DescriptionThis article shows how to look at objectfactory.config and determine if you are using a strategy, and whether it is using a .DLL or a file from the App_Code folder. ResolutionGo to Siteroot/objectFactory.config .Here is the file from a min site: <objectfactory>   <ob...

  • Extending LibraryManager.DataClasses.LibraryData sorting using LINQ
    The Legacy Ektron.Cms.API.Library is replaced by Ektron.Cms.API.LibraryManger() in the current CMS versionThe LibraryManger() uses a LibraryCriteria.AddFilter(...). The sort is limited by the LibraryCriteria.AddFilter use of LibraryProperty. This has a limited set of values.    The retr...

  • External Link Disclaimer
    This KB article shows you how to add an "exit disclaimer" to external links on a page.   Resolution You can have "NOTE: External link" after every external link.You can use JQUERY to automatically add alerts or call another function when pressing the...

  • Generate Class for Smart Form
    DescriptionCreate a C# or VB.NET class to programmatically access Smart Form data. Smart Form data is XML and may be processed using XSLT, an XML parser (XmlDocument), Linq/XQuery or even as a string. It may also be deserialized into a .NET object given a C# or VB.NETclass.This article describes...

  • getList parameter data type of UInt32 is invalid
    DescriptionUsing getList may generate an error ( The parameter data type of UInt32 is invalid ) because of a Microsoft SQL bug in Framework 4.5. This can occur in any Framework API getList call with the ContentManager, FolderManager, TaxonomyManager, and so on.  CauseSQL interprets a valu...

  • Google Map API 2.0 Deprecated
    DescriptionEktron is working on patching the Google Map javascript integration. The V2 API will continue to work until May 19, 2013. By that time we should have a patch available for the most recent version of the CMS. Resolution  Google deprecated their older v2 Javascript API of Google Ma...

  • Hide Youtube suggested videos from displaying when using Youtube Widget
    DescriptionWhen using the Ektron Youtube Widget it by default displays the suggested videos Youtube provides at the end of the playback.  Some customers do not want to see these videos as they may not be appropriate with the content they are interested in showcasing. ResolutionThe widget it...

  • How do I verify what versions of .NET framework are installed on my server?
    DescriptionHow do I verify what versions of .NET framework are installed on my server? ResolutionIt can be critical to know what versions of Microsoft .NET framework are installed on your server to diagnose different issues. It can be even more critical to know if the FULL or CLIENT version...

  • How to adjust the page size on server controls or API
    When you attempt to populate a list of items using a server control or the API (Legacy/Framework), it defaults to displaying up to 50 items. Cause The default for most server controls and API calls are to return 50 results to improve performance. Resolution ...

  • How to change the maximum sizes of an avatar image
    DescriptionThis KB article shows how to increase the maximum file size for an avatar.Several fields in the Ektron Workarea let you upload an avatar. For example, when you create/edit users and membership users. By default, an avatar's maximum file size is 200 kilobytes, and its height and width ...

  • How to create a Constants class
    DescriptionEktron uses a constants class named "Constants." If you create a similar class called "Constants" in app code, you can prevent Ektron components from working because the Constants class is referenced throughout the Ektron API. ResolutionAdd a namespace to your...

  • How to customize the Web Calendar Style Sheet
    DescriptionThis KB aticle shows how to customize the Web calendar style sheet ( WebCalendar.css ), located in \siteroot\workarea\WebCalendar\View . ResolutionImportant! Files stored in the siteroot\workarea folder are overwritten (or deleted) when you upgrade. To avoid problems, back u...

  • How to customize the Web Calendar Tooltip
    DescriptionIf you hover over a calendar event, a tooltip automatically shows its details. This KB article shows how to modify the tooltip display. ResolutionThe telerik:RadToolTip properties govern how the tool tip displays.You can apply many changes to a tool tip. The following example m...

  • How To Detect Server Type Setting in CMS via Ektron API
    Description This article demonstrates the Ektron code that can be used to detect the Server Type setting in the CMS>Settings>Setup>General Tab as seen in the image below.   Resolution The code below will retrieve the setting indicated above. protected void Page_Load(obje...