DirigoEdge is an Open Source CMS development framework built on ASP.Net C# that makes managing content and building websites faster and easier. It is fully responsive, built on MVC, Microsoft’s CodeFirst, and has a robust shortcode and plugin system.
Explore DirigoEdge functions on our YouTube channel
DirigoEdge uses node-sass
and gulp
to watch and compile Sass. You must have Node 0.10.x or 0.12.x installed. You can download Node.js here.
DirigoEdge will install any local Node.js module dependencies on first build, but gulp
must also be installed globally. To install gulp
run the following in Command Prompt:
npm install -g gulp
Don't want to read? Try our Installing DirigoEdge v2.0 video
-
For the stable version, grab the latest release. For the latest (unstable) development version, clone this repo with
git clone https://github.com/dirigodev/DirigoEdge.git
-
Edit
web.config
file with your appopriate database connections. -
Set Up Membership provider on your SQL Database:
- Run
aspnet_regsql.exe
on your database and follow the on screen instruction. This program installs various sql tables and stored procedures required by the .Net Membership provider.- The reg sql program is typically found: C:\Windows\Microsoft.NET\Framework\v4.0.30319 (your .Net version may vary)
- If you're unfamiliar with
aspnet_regsql.exe
refer to this walkthrough
- Run
-
Run the application and create a new user.
- Running the application for the first time will seed the database and provide you with some initial content to play around with.
- When you register a new user, you will be added as an Administrator.
- After you create a user and have successfully logged in, you may add a registration code under Users > Roles.
-
You may need to set permissions on the folders
uploaded
andscripts
so that the 'IISUSR' and 'ISUR' has full permission- Edge will automatically combine and minify your CSS and Javascript files in this directory when you publish your solution or run in Release mode
- More information on SquishIt can be found at https://github.com/jetheredge/SquishIt
-
Check out our video series on YouTube
DirigoEdge and its plugins depend on DirigoEdgeCore. Stable versions are available and will be automatically installed from NuGet. If you would like to work with the latest development build of Core you'll need to pull down the project.
Clone the repo from GitHub. This will automatically pull down the develop
branch
$ git clone https://github.com/dirigodev/DirigoEdgeCore.git
Once you've opened the project in Visual Studio you'll need to do a build. This will automatically generate a new NuGet package in DirigoEdgeCore/bin
.
In Package Manager Settings go to NuGet Package Manager > Package Sources. Add a new source and point it to C:\path\to\DirigoEdgeCore\bin
. Make sure you hit Update when you're done.
You can change the order in which NuGet looks for packages here, or you can explicitly set it in the Package Manager Console.
Now you're ready to install DirigoEdgeCore in the Package Manager Console. If you didn't set your local package source at the top of list, be sure to set Package source to your local source.
Now you are ready to update the package. The -Reinstall
flag is necessary if you have made changes to DirigoEdgeCore and haven't changed the version in the nuspec file.
update-package DirigoEdgeCore -Reinstall
Bugs, feature requests, and other issues can be submitted in GitHub issues.
Before submitting an issue search through open and closed issues to see if your problem has already been resolved or is under discussion.
All development work for DirigoEdge is done on the develop
branch. Any new code contributions should be made on (or branched off) this branch.
Fork the project on GitHub and check out your copy locally.
$ git clone https://github.com/dirigodev/DirigoEdge.git
$ cd DirigoEdge
$ git remote add upstream git://github.com/dirigodev/DirigoEdge.git
Create a new branch for your feature or bug fix
$ git checkout -b my-feature-branch -t origin/develop
Try to keep your commit history clean. Your commit messages should concisely describe all the change contained within the commit.
If you have a lot of small commits, consider squashing your commits.
Pull requests with merge conflicts will not be accepted. Rebasing your fork from time to time while you're working on it will prevent major headaches when you're ready to submit your PR.
Use git rebase
(not git merge
) to sync your work from time to time.
$ git fetch upstream
$ git rebase upstream/develop
$ git push origin my-feature-branch
Go to https://github.com/yourusername/DirigoEdge and select your feature branch. Click the 'Pull Request' button and fill out the form.
Changes will be reviewed by the DirigoEdge core team. If there are comments to address, apply your changes in a separate commit and push that to your feature branch. This will automatically update your pull request.