...
Select ASP.Net Web Application as the project type
Warning |
---|
Do not call the new Solution or Project 'Lynicon' (or Lynicon.Base or any other such name) as it will cause assembly linking problems |
Choose the MVC template
Install Lynicon
To install Lynicon as find it is not currently in the NuGet library, you will need to set up a local Nuget feed which is described here.
Open the NuGet Package Manager and select the Local package source, choose Nuget Gallery on nuget.org
Choose Lynicon.Identity package. This automatically performs all the steps in Manual Installation and Generic ASP.Net Identity.
...
Set the Connection String to the Database
Determine a SQL database locally or remote which will host the content and user data. In web.config, set the value for the connection string element which has been created by the installation, and also the DefaultConnection connection string which already existed (ensuring user tables are created in the same database as content tables):
Code Block | ||
---|---|---|
| ||
<connectionStrings> <add name="DefaultConnection" connectionString="..." providerName="System.Data.SqlClient" /> <!-- Add lynicon database connection string here, or delete if no database being used --> <add name="LyniconContent" connectionString="..." /> </connectionStrings> |
Run the SQL script at /Areas/Lynicon/Admin/SQL/LyniconCoreInit.sql against the database to create the initial tables for Lynicon.
Set up an Admin User
Run the site locally. On the home page the template has created, select Register in the top black bar at the right to create a user account which will be the initial admin user. Fill in the form this takes you to:
This will create a user record, but in order to do this it will also run EF Migrations to create the tables for standard ASP.Net Identity. If you return to inspect the database you will find these have been created.
Now the final task is to create the Lynicon roles and add them to the user you have created. Run the SQL script at /Areas/Lynicon/Admin/SQL/SetUpIdentity.sql against the database, which will create the default roles for Lynicon and make all currently existing users Admins in the CMS.
...
Warning |
---|
If you want to use the default connection string to a local .mdf in App_Data set up by VS scaffolding, you will need to modify it so that:
|
Build the Site
Run a build on the site as the commands you are about to run will load the current site's compiled code in order to enable them to execute, and they won't work without this step.
Build the Database
If you used the default connection string from the project scaffolding which points to an .mdf file in App_Data, you will need to ensure the database is created before running the initialization commands.
These initialize and activate Entity Framework Migrations.
- Enable-Migrations: this sets up the project for migrations
- Add-Migration -Name Init: this creates the first migration to create the database with ASP.Net Identity tables set up
- Update-Database: this runs the migration
Run the Initialization Commands
Go to the Package Manager console. Lynicon has installed Powershell commands to set up the CMS. The commands to run (in this order) are shown in the image. They are:
- Initialize-LyniconProject: this inserts commands into the Global.asax.cs to run lynicon initialization, and into FilterConfig.cs to set up Lynicon's MVC script manager
- Initialize-LyniconDatabase: this builds the core database tables needed for Lynicon
- Initialize-LyniconAdmin: this creates an admin user for Lynicon with all the admin roles, allowing you to access the CMS editor and back end. You have to supply a Password parameter ensuring that the admin password is never set to a default value. Ensure you use single quotes for the password to avoid issues with special characters. The admin user's username is 'administrator' and the default email is 'admin@lynicon-user.com'
Warning |
---|
Ensure you only have one instance of Visual Studio running when you run these commands or they may fail |
First Run
If you now run the site and log in as the administrator you will be able to see the Lynicon pages as described in the the User Manual. Lynicon is now ready to be used for CMS functions.
Warning |
---|
You have to log in via the /lynicon/login page rather than the /account/login page which is part of the startup site template, as the latter assumes that the user name is the same as the email for all users |
To now set up a basic content-managed model, route and view, consult the the Hello World page.