Local Development Setup with Visual Studio - Eonic/ProteanCMS GitHub Wiki
For your first project do this
First Clone ProteanCMS to D:/HostingSpaces/ProteanCMS and ProteanCMS-AddOns to D:/HostingSpaces/ProteanCMS-AddOns
Open ProteanCMS.Sln in Visual Studio.
In the package manager console run...
Update-Package -reinstall
This will get all the lastest 3rd Party Packages.
Subsequent projects start here
Now you can create the solution
We recommend the use Git for managing projects so first you need to create an empty Repo in Git and clone it to your local machine we recommend using a folder D:/hostingspaces/YourClients/repo-name.
If you are using Azure Devops, once you have create a project, go to the project and click Repos on the left menu. If a new project there will be an empty repo to clone.
For a new repo for a project with existing repos, click the top bar repo-name dropdown to add a new repo or switch between available ones.
Copy the Repo URL an open visual studio choose the clone repo option paste the URL and specify the local directory... D:/hostingspaces/YourClients/your-local-project-name (we suggest just the client name)
In Visual Studio create a blank solution and save in D:/hostingspaces/YourClients/your-local-project-name
Create your local website in IIS, we use hostfileeditor to create a local hostname using local.mywebsite.com as the hostname. in the folder D:/hostingspaces/YourClients/repo-name/wwwroot
Copy the wwwrootV6 into a website folder
Create a new database and update the databasename and credentials in protean.web.config
Modify the theme paths in admin.xsl and shared.xsl for the /ptn files to ../../../../../ (x5)
Add website to the Solution
Ensure the website is set to Framework 4.8
Add Existing Project:
D:\HostingSpaces\ProteanCMS\Assemblies\Protean.Tools
D:\HostingSpaces\ProteanCMS\Assemblies\ProteanCMS
Add any Providers found in e.g.
D:\HostingSpaces\ProteanCMS Addons\Providers\Messaging\CampaignMonitor Add References to the website
Project Dependencies (wwwroot dependent on ewCommon) (ewcommon depends on Tools/CMS) (CMS on Tools)
Build
Commit the solution and the files.
If you want to reinstall the packages to the same versions as were previously installed then you can use the -reinstall argument with Update-Package command. Update-Package -reinstall You can also restrict this down to one project. Update-Package -reinstall -Project YourProjectName