Skip to content

Composite C1 3.0

Compare
Choose a tag to compare
@pashakuzm pashakuzm released this 26 Nov 13:44
· 4945 commits to master since this release

Composite C1 3.0 (3.0.4358.29126)

This is the first major release since the CMS became available as free open source. This release focus on user experience, stability, performance and better tooling for users and developers.

Getting started

If you are new to Composite C1 and want to install it: http://docs.composite.net/Getting-started

Upgrade guidelines

  • Composite provide an upgrade service where you can upgrade using an automated tool - for details see http://www.composite.net/Products/Plans
  • Upgrading from v. 2.1 manually: see below
  • Upgrading from 3.0 RC2, RC3 and RC4: see below

What's new in Composite C1 3.0?*

For an overview of top features and screenshots, visit http://composite.net/3

  • Paste from Word into Visual Editor content (without markup going bad)
  • Page URL’s look perfect
  • Instant image and document upload - File selectors, insert image/file link dialogs allow users to manage folders and upload new files immediately.
  • Easy in-place image resizing
  • HTML 5, script, iframe etc. support in the Visual Editor
  • The calendar control is user friendly now
  • A ton more user experience improvements
  • ASP.NET Razor for templates and functionality
  • Starter sites for HTML, Razor, ASP.NET Master pages and XSLT
  • C1 Function test and documentation tool
  • Building C1 Functions with parameters is easier
  • Selection dialogs that order data in tree views will now re-open at last viewed position and trees will auto-expand when convenient.
  • ASP.NET Controls registered as C1 Functions are now available for insert in the Visual Editor
  • The source code editor now use TAB for indention. Developers using Firefox can control the tab width (default is 4) through CSS.
  • Page meta data can now be shared across all languages.
  • The internal build system in Composite C1 responsible for binding the dynamic data features to .NET and LINQ have been thoroughly refactored yielding better performance and doing away with issues with instability and slow system startup times.
  • SQL Server Data provider is no longer dependant on MS SQL DMO
  • SQL Azure fully supported
  • Composite Start screen can now be invoked from Tools button.
  • Media file links are now more human and SEO friendly. The media ID is toned down in URL’s and decorated with the file name making is easier to read for humans and search engines.
  • Full support for running Composite C1 in a sub folder (IIS application)
  • Build in page browser reflect host name changes for installations hosting multiple sites with unique host names.
  • ASP.NET Routing used to handle requests.
  • Page cache settings moved from Page.aspx to web.config
  • Expanded public API.
  • Log activity primarily of interest for core team reduced.
  • Dynamic data type fields need no longer have a widget defined.
  • The assemblies “Composite” and “Composite.Workflow” are no longer merged in the release binaries.
  • IP address logged on failed login attempts
  • All known stability and xml data corruption issues fixed
  • An API for commercial packages* Lots of bugs fixes

Manual upgrade from 2.1 to 3.0

Requirements for upgrade

  1. Your site should already be running on C1 2.1.1 or newer version
  2. Visual Studio 2010
  3. A tool for mergin code files. Recommended software is TortoiseMerge, it's free and can be download as a part of TortoiseSVN (http://tortoisesvn.net/downloads.html)

Upgrade steps:

  1. Remember to create a backup copy of your site. Stop the related application pool on IIS/WebMatrix before upgrading.

  2. If you don't have TortoiseMerge installed, download and install it as a part of TortoiseSVN (http://tortoisesvn.net/downloads.html)

  3. Download & build C1 version you're going to upgrade to (C1 v3.0 RTM)

  4. Merge changes to web.config.

Use Visual Studio (or another text editor) to format your site's web.config. In VS the hotkeys are Ctrl+A, Ctrl+K-F

Download web.config versions for C1 2.1.1 and C1 3.0 RTM

http://docs.composite.net/Downloads/UpgradeFiles/3.0/web6706.xml
http://docs.composite.net/Downloads/UpgradeFiles/3.0/web9387.xml

Run TortoiseMerge to merge the changes. The setup is:

"Base file" = web6706.xml (web.config from 2.1.1)
"Their file" = web9387.xml (web.config from 3.0 RTM)
"My file" = web.config from your site

Most of the changes likely will be merged automatically, resolve the conflicts and save the merged file

  1. Perform the same steps to merge changes to file /App_Data/Composite/composite.config
    Format xml in Visaul Studio Download composite.config versions for C1 2.1.1 and C1 3.0 RTM

http://docs.composite.net/Downloads/UpgradeFiles/3.0/composite6706.xml
http://docs.composite.net/Downloads/UpgradeFiles/3.0/composite9387.xml

Before running mergin tool edit the config file and move section "loggingConfiguration" to the bottom of the file

    ...
 <loggingConfiguration name="Logging Application Block" tracingEnabled="true" defaultCategory="General" logWarningsWhenNoCategoriesMatch="true"> 
   ....
 </loggingConfiguration>
</configuration>

Run TortoiseMerge to merge the changes. The setup is:
"Base file" = composite6706.xml (composite.config from 2.1.1)
"Their file" = composite9387.xml (composite.config from 3.0 RTM)
"My file" = /App_Data/Composite/composite.config from your site

  1. Updating files & folders.
    Copy from the new site (and override if necessary) the following files:

\default.aspx
\App_Data\Composite\Configuration\UrlFormatting.xml
\App_Data\Composite\TreeDefinitions\UrlConfiguration.xml
\Bin\Composite.dll
\Bin\Composite.Workflows.dll
\Frontend\Config\VisualEditor\common.xml (merge custom changes if needed)
\Frontend\Config\VisualEditor\Styles\core.css

Delete the following file:

\App_Data\Composite\Configuration\XmlDataProvider.config

Copy and override all the files from the following folders (note: not including subfolders)

\Composite*.*
\Composite\localization*.*
\Renderers*.*

Delete and copy the following folders

\Composite\content
\Composite\controls
\Composite\flash
\Composite\images
\Composite\services
\Composite\scripts
\Composite\schemas
\Composite\skins
\Composite\styles
\Composite\transformations
\Composite\templates\

  1. #888888">[Not needed while upgrading from C1 2.1.3 or newer version]. If “Composite.Community.Blog” or “Composite.News” are installed, download and replace related dlls:

http://docs.composite.net/Downloads/Temp/2.1.3Beta2/Composite.Community.Blog.dll
http://docs.composite.net/Downloads/Temp/2.1.3Beta2/Composite.News.dll

  1. #888888">[Not needed while upgrading from C1 2.1.3 or newer version]. Upgrade steps for Composite.Contrib project:

a) Uninstall Contrib package.
b) download a newer package file Contribution.CompositeC1Contrib.Core/Release/Contribution.CompositeC1Contrib.Core.zip from http://c1packages.codeplex.com/SourceControl/changeset/changes/8618
c) In C1 Console find System -> Packages -> Installed packages -> Local packages, right click choose "Install local package" and choose the package you downloaded in the previous step

Smooth upgrade from RC2, RC3 and RC4

We have added a package online which will upgrade you from RC2, RC3 and RC4 - here is how to install it:

  1. Log in to the C1 Console
  2. Go to the System perspective
  3. Open folders "Packages | Available Packages | Composite.Updates"
    (if you don't have that folder you are likely on 3.0 RTM already or running an older version)
  4. Execute 'Package Info' on the package named "Composite C1 3.0"
    5.Package info document loads - click "Install" og follow the wizard