Is this really the version you are looking for? Kentico Xperience 9 Documentation is no longer updated. Use the switcher in the header to choose your product version.
Kentico 9 stops supporting the project management feature, as well as several other web parts and widgets that were present in previous versions. For example, the abandoned web parts include the Document library and Drop-down menu. See the complete list of abandoned web parts and widgets below.
This page describes how to deal with the abandoned features and components after performing the upgrade procedure. You either need to delete the corresponding components and data or recover the required code files.
Download and use the following packages:
The upgrade procedure deletes all source files of the abandoned web parts, but their database records remain in the database. This ensures you can recover any of the removed web parts or widgets that you use on your site and make everything work as before the upgrade. You do not need to worry about losing these web parts from your site's pages and templates (their configurations is stored in the database).
Go through the list list of abandoned web parts and widgets and take the desired action for each component. Follow the steps in the sections below to either remove or recover the listed web parts or widgets.
Important: The abandoned web parts will not be considered in future Kentico versions and anything that you recover becomes your own custom code. You have access to all source files of the web parts and are free to modify them, but you need to maintain them yourself.
Start by determining whether your site actively uses the given widget:
If you are NOT using the widget, delete the widget in the Widgets application.
If you are using the widget, you have the following options:
Start by determining whether your site actively uses the given web part:
If you are NOT using the web part, delete the web part in the Web parts application.
If you are using the web part, you have the following options:
Recover the web part – find the web part in the list of abandoned web parts and perform the following steps:
Open your Kentico project in Visual Studio.
Include the copied files into the CMSApp project (or CMSApp_AppCode for files in the Old_App_Code folder).
Add any assembly references required by the web part (see the Additional modifications table column).
Convert the added files to the web application format:
Build the affected projects (CMSApp, CMSApp_AppCode).
– OR –
Replace the web part with a different set of Kentico web parts or create your own web part according to your needs. Delete the abandoned web part in the Web parts application.
The following is a list of widgets that were removed in Kentico 9.
Display name | Code name | Removed parent web part |
|---|---|---|
Article list | ArticleList | |
Article list | ArticleListEditors | |
Articles RSS Feed | ArticlesRSSFeed | |
Blog posts RSS feed | BlogPostsRSSFeed | |
Blog posts RSS feed | BlogPostsRSSFeedEditors | |
Building your on-line store | BuildingYourOnlineStore | |
Document library | DocumentLibrary | Document library |
Drop-down menu | cmsmenu_1 | Drop-down menu |
E-commerce settings checker | EcommerceSettingsChecker | E-commerce settings checker |
News RSS Feed | NewsRSSFeed | |
Latest blog posts | LatestBlogPostsEditors | |
Latest blog posts | LatestBlogPostsUsers | |
Latest news | LatestNewsUsers | |
Latest news | LatestNewsEditors | |
Latest news for Corporate site | CorporateSite.LatestNewsEditors | |
My projects | MyProjects | My projects |
Social bookmarking | SocialBookmarking | Social bookmarking |
Tasks assigned to me | TasksAssignedToMe | Tasks assigned to me |
Tasks owned by me | TasksOwnedByMe | Tasks owned by me |
Tree Menu | cmstreemenu_1 | Tree menu |
The following is a list of web parts and server controls that were removed in Kentico 9.
All recovery files except for the document library and project management web parts are located in the Web part and widget recovery (opens in a new tab) package.
Note: Always copy the listed ascx files along with their corresponding code behind file (.ascx.cs).
Display name | Code name | Web part files | Additional modifications |
|---|---|---|---|
Article list | ArticleList | None | Inherited from the Repeater web part. You do not need to recover any files, only decide whether to delete or keep the web part in the Web parts application. |
Articles RSS feed | ArticlesRSSFeed | None | Inherited from the CMS RSS feed web part. You do not need to recover any files, only decide whether to delete or keep the web part in the Web parts application. |
Attachments Lightbox | AttachmentsLightbox | ~/CMSWebParts/Viewers/Effects/jQueryFancyBox_files/ | |
Attachment image gallery | AttachmentImageGallery | ~/CMSWebParts/attachments/attachmentlightboxgallery.ascx | |
Attachments Carousel | Attachments Carousel | ~/CMSSripts/jquery/jquery-carousel.js | |
Attachments Carousel 3D | AttachmentsCarousel3D | ~/CMSSripts/jquery/jquery-cloud-carousel.js | |
Blog posts RSS Feed | BlogPostsRSSFeed | None | Inherited from the CMS RSS feed web part. You do not need to recover any files, only decide whether to delete or keep the web part in the Web parts application. |
Drop-down menu | cmsmenu | ~/CMSWebParts/Navigation/cmsmenu.ascx ~/CMSScripts/skmmenu.js ~/CMSScripts/skmmenuup.js ~/App_Code/skmMenu ~/App_Code/CMSControls/CMSMenu.cs Web application projects Copy the folders and files from ~/App_Code into the ~/Old_App_Code folder instead. You then need to include these files into the CMSApp_AppCode project in Visual Studio. | Web application projects
C# Web site projects
C# |
Document library | DocumentLibrary | All files in the Document library recovery (opens in a new tab) package. | On web site projects, restart the application after you copy the document library files – open the System application in the Kentico administration interface and click Restart application. |
E-commerce settings checker | EcommerceSettingsChecker | ~/CMS/CMSWebParts/Ecommerce/EcommerceSettingsChecker.ascx | |
Facebook activity feed | FacebookActivityFeed | ~/CMS/CMSWebParts/SocialMedia/Facebook/FacebookActivityFeed.ascx | |
Facebook comments | FacebookComments | ~/CMS/CMSWebParts/SocialMedia/Facebook/FacebookComments.ascx | |
Facebook facepile | FacebookFacepile | ~/CMS/CMSWebParts/SocialMedia/Facebook/FacebookFacepile.ascx | |
Facebook like box | FacebookLikeBox | ~/CMS/CMSWebParts/SocialMedia/Facebook/FacebookLikeBox.ascx | |
Facebook like button | FacebookLikeButton | ~/CMS/CMSWebParts/SocialMedia/Facebook/FacebookLikeButton.ascx | |
Facebook recommendations | FacebookRecommendations | ~/CMS/CMSWebParts/SocialMedia/Facebook/FacebookRecommendations.ascx | |
Facebook send button | FacebookSendButton | ~/CMS/CMSWebParts/SocialMedia/Facebook/FacebookSendButton.ascx | |
Google+ +1 button | GooglePlusButton | ~/CMS/CMSWebParts/SocialMedia/GooglePlus/GooglePlusButton.ascx | |
Google+ activity feed | GooglePlusActivityFeed | ~/CMS/CMSWebParts/SocialMedia/GooglePlus/GooglePlusActivityFeed.ascx | |
Google+ badge | GooglePlusBadge | ~/CMS/CMSWebParts/SocialMedia/GooglePlus/GooglePlusBadge.ascx | |
Group document library | GroupDocumentLibrary | All files in the Document library recovery (opens in a new tab) package. | On web site projects, restart the application after you copy the document library files – open the System application in the Kentico administration interface and click Restart application. |
Language selection | languageselection | ~/CMS/CMSWebParts/Localization/languageselection.ascx ~/App_Code/CMSPortalControls/WebParts/CMSAbstractLanguageWebPart.cs Web application projects Copy the folder and files from ~/App_Code into the ~/Old_App_Code folder instead. You then need to include these files into the CMSApp_AppCode project in Visual Studio. | |
Language selection drop-down | languageselectiondropdown | ~/CMS/CMSWebParts/Localization/languageselectiondropdown.ascx ~/CMS/CMSWebParts/Localization/dd_arrow.gif ~/CMS/CMSWebParts/Localization/langselector.css ~/App_Code/CMSPortalControls/WebParts/CMSAbstractLanguageWebPart.cs Web application projects Copy the folder and files from ~/App_Code into the ~/Old_App_Code folder instead. You then need to include these files into the CMSApp_AppCode project in Visual Studio. | |
Language selection with flags | languageselectionwithflags | ~/CMS/CMSWebParts/Localization/languageselectionwithflags.ascx ~/App_Code/CMSPortalControls/WebParts/CMSAbstractLanguageWebPart.cs Web application projects Copy the folder and files from ~/App_Code into the ~/Old_App_Code folder instead. You then need to include these files into the CMSApp_AppCode project in Visual Studio. | |
Latest news | LatestNews | None | Inherited from the Repeater web part. You do not need to recover any files, only decide whether to delete or keep the web part in the Web parts application. |
Lightbox gallery | lightbox | ~/CMSWebParts/Viewers/Effects/lightbox.ascx | |
LinkedIn company insider | LinkedInCompanyInsider | ~/CMS/CMSWebParts/SocialMedia/LinkedIn/LinkedInCompanyInsider.ascx | |
LinkedIn company profile | LinkedInCompanyProfile | ~/CMS/CMSWebParts/SocialMedia/LinkedIn/LinkedInCompanyProfile.ascx | |
LinkedIn member profile | LinkedInMemberProfile | ~/CMS/CMSWebParts/SocialMedia/LinkedIn/LinkedInMemberProfile.ascx | |
LinkedIn share button | LinkedInShareButton | ~/CMS/CMSWebParts/SocialMedia/LinkedIn/LinkedInShareButton.ascx | |
My projects | MyProjects | See the Project management section. | |
News list | NewsList | None | Inherited from the Repeater web part. You do not need to recover any files, only decide whether to delete or keep the web part in the Web parts application. |
News RSS Feed | NewsRSSFeed | None | Inherited from the CMS RSS feed web part. You do not need to recover any files, only decide whether to delete or keep the web part in the Web parts application. |
Product filter | ProductFilter | ~/CMS/CMSModules/Ecommerce/Controls/Filters/ProductFilter.ascx ~/CMS/CMSWebParts/Ecommerce/Products/ProductFilter.ascx | |
Project list | ProjectList | See the Project management section. | |
Project tasks | ProjectTasks | See the Project management section. | |
Pinterest follow button | PinterestFollowButton | ~/CMS/CMSWebParts/SocialMedia/Pinterest/PinterestFollowButton.ascx | |
Pinterest pin it button | PinterestPinItButton | ~/CMS/CMSWebParts/SocialMedia/Pinterest/PinterestPinItButton.ascx | |
Repeater with Carousel | RepeaterWithCarousel | ~/CMSSripts/jquery/jquery-carousel.js | |
Repeater with Lightbox | RepeaterWithLightbox | ~/CMSWebParts/Viewers/Effects/jQueryFancyBox_files/ | |
Scrolling news | ScrollingNews | None | Inherited from the Scrolling text web part. You do not need to recover any files, only decide whether to delete or keep the web part in the Web parts application. |
SharePoint data source (obsolete) | SharePointDataSource | - | The obsolete SharePoint web parts were removed without any recovery options. The upgrade automatically deletes the web parts from the database and file system. See the Integrating SharePoint chapter to learn how to display SharePoint content without the obsolete web parts. |
SharePoint datagrid (obsolete) | SharePointDatagrid | - | |
SharePoint datalist (obsolete) | SharePointDatalist | - | |
SharePoint repeater (obsolete) | SharePointDataViewer | - | |
Shopping cart preview | ShoppingCartMiniPreview | ~/CMS/CMSWebParts/Ecommerce/ShoppingCart/ShoppingCartMiniPreviewWebPart.ascx | |
Social bookmarking | SocialBookmarking | ~/CMS/CMSWebParts/SocialMedia/SocialBookmarking.ascx | |
Task info panel | TaskInfoPanel | See the Project management section. | |
Tasks assigned to me | TasksAssignedToMe | See the Project management section. | |
Tasks owned by me | TasksOwnedByMe | See the Project management section. | |
Tree menu | cmstreemenu | ~/CMS/CMSWebparts/Navigation/cmstreemenu.ascx ~/CMSScripts/Controls/treemenu.js ~/App_Code/CMSControls/CMSTreeMenu.cs Web application projects Copy the folder and files from ~/App_Code into the ~/Old_App_Code folder instead. You then need to include these files into the CMSApp_AppCode project in Visual Studio. | Web application projects
C# |
Twitter feed | TwitterFeed | ~/CMS/CMSWebParts/SocialMedia/Twitter/TwitterFeed.ascx | |
Twitter follow button | TwitterFollowButton | ~/CMS/CMSWebParts/SocialMedia/Twitter/TwitterFollowButton.ascx | |
Twitter tweet button | TwitterTweetButton | ~/CMS/CMSWebParts/SocialMedia/Twitter/TwitterTweetButton.ascx |
The project management features are no longer supported in Kentico 9. Decide whether you wish to continue using project management after you perform the upgrade procedure.
If you do NOT use project management, download the Project management database cleanup (opens in a new tab) package. The package contains SQL scripts that remove all data related to project management from your upgraded database.
Run the SQL scripts against your database in the following order:
If you wish to continue using project management after you upgrade, download the Project management recovery (opens in a new tab) package and perform the following steps:
Note: You cannot recover project management for new Kentico 9 installations. The process only works for upgraded instances.
Important: Project management will not be considered in future Kentico versions. The recovery package gives you access to all project management files and source code and you are free to modify anything. However, the files become your own custom code that you need to maintain.
Copy all folders from the recovery package into your Kentico project's CMS folder and merge all content.
Open your Kentico solution in Visual Studio.
Click File -> Add -> Existing Project and choose the CMS\ProjectManagementLibrary\ProjectManagement.csproj file.
Unfold the References section of the ProjectManagement project and delete all invalid references.
Add references to the required libraries in your Kentico project:
Right-click the ProjectManagement project and select Add Reference.
In the Reference Manager dialog, click Browse and navigate to the Lib folder of your Kentico web project.
Add references to the following libraries:
Build the ProjectManagement project.
Web site Kentico projects - copy the resulting CMS.ProjectManagement.dll file into the Kentico project's CMS\bin folder. The built DLL is located in the ProjectManagementLibrary\bin\Debug (default) or Release folder.
Web application Kentico projects - you need to perform additional steps:
Move the content from the copied CMS\App_Code folder into the CMS\Old_App_Code folder within your project files (you can then delete the App_Code folder).
Include the copied folders and files into the Kentico projects:
Convert the added files to the web application format:
Add references from the CMSApp and CMSApp_AppCode projects to ProjectManagement:
Build the Kentico solution.
To finish the recovery (for both web application and web site projects), recreate a project management property that the upgrade deleted from the Group profile web part:
You can now continue using project management features on your upgraded website (all related applications, web parts and widgets).
Web site projects
<pages ...>
<controls>
<add tagPrefix="cms" namespace="CMS.Controls" />
...