Skip to content

Latest commit

 

History

History
86 lines (52 loc) · 5.45 KB

README.md

File metadata and controls

86 lines (52 loc) · 5.45 KB
Raw

CarrotCakeCMS-MVC

Source code for CarrotCakeCMS (MVC), ASP.Net 4.5

Welcome to the GitHub project for CarrotCake CMS MVC, an open source c# project. CarrotCake is a template-based MVC5 ASP.Net CMS (content management system) built with C#, SQL server, jQueryUI, and TinyMCE. This content management system supports multi-tenant webroots with shared databases.

If you have found this tool useful please contact us.

Source code and documentation is available on GitHub and SourceForge. Documentation and assemblies can be found here.

Some features include: blogging engine, configurable date based blog post URLs, blog post content association with categories and tags, assignment/customization of category and tag URL patterns, simple content feedback collection and review, blog post pagination/indexes (with templating support), designation of default listing blog page (required to make search, category links, or tag links function), URL date formatting patterns, RSS feed support for posts and pages, import and export of site content, and import of content from WordPress XML export files.

Other features also include date based release and retirement of content - allowing you to queue up content to appear or disappear from your site on a pre-arranged schedule, site time-zone designation, site search, and ability to rename the administration folder. Supports the use of layout views to provide re-use when designing content view templates.

CarrotCakeCMS (MVC) Developer Quick Start Guide

Copyright (c) 2011, 2015, 2023 Samantha Copeland Licensed under the MIT or GPL v3 License

CarrotCakeCMS (MVC) is maintained by Samantha Copeland

Install Development Tools

  1. Visual Studio Community/Express/Pro/Enterprise (ISO VWD 2013, ISO CE 2013, or ISO CE 2015) Professional (or higher) editions OK. Typically being developed on VS 2015 Enterprise or VS 2019 Express. Even VS 2012 is OK, the database project won't load, but that's OK because it's just there to maintain a schema history, it is not a required of part of the build
  2. SQL Server Express 2008 (or higher/later) - currently vetted on 2008, 2012R2, and 2016 Express.
  3. SQL Server Management Studio (SSMS) - required for managing the database

Get the Source Code

  1. Go to the repository (GitHub or SourceForge) in a browser

  2. Download either a GIT or ZIP archive or connect using either a GIT or SVN client

Open the Project

  1. Start Visual Studio

  2. Open CarrotCakeMVC.sln solution in the root of the repository

    Note: If your file extensions are hidden, you will not see the ".sln" Other SLN files are demo widgets for how to wire in custom code/extensions

  3. Edit Web.config under CMSAdmin root directory (this corresponds to the CMSAdminMVC project)

    • In the connectionStrings section, configure the CarrotwareCMSConnectionString value to point to your server and the name of your database. Note: the credentials require database owner/dbo level as it will create the database artifacts for you.
    • In the mailSettings, configure the pickupDirectoryLocation to a directory on your development machine (for testing purposes).

  4. Right-click on CMSAdminMVC and select Set as StartUp Project

  5. Right-click on CMSAdminMVC and select Rebuild. The project should download all required NuGet packages and compile successfully

    There may be some warnings, you can ignore them

  6. SQL Server should be running with an empty database matching the one specified in the connection string. If you are running the code a second or later time, it will auto update if there are schema changes (see dbo note above). Do not share a database between the Core, MVC 5, and WebForms editions.

  7. if the database is empty or has pending database changes, you will be greeted with a maintenance screen, follow the link provided.

  8. The first time you start up the website, it will create the required artifacts in the database (tables/views/sprocs etc.)

  9. Click the Play button (or hit F5) in the main toolbar to launch CarrotCakeCMS

  10. When you run the website with an empty user database, you will be prompted to create the first user

  11. Once you have created a user, you can go to the login screen, enter the credentials

  12. After successfully logging in, you can create and manage your new website

Using CarrotCakeCMS

For additional information on how to use CarrotCakeCMS, please see the CarrotCakeCMS Documentation.