A flexible and lightweight Umbraco based framework, for making an Intranet, Extranet or social platform based on known conventions.
Switch branches/tags
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Img Add files via upload Oct 31, 2018
cakeBuild Fix cake build file Jul 5, 2018
src Fix trasformations. Dec 3, 2018
.gitattributes Add Web.Compent.Debug configuration Jun 18, 2018
.gitignore Updated .gitignore Sep 10, 2018
CONTRIBUTING.md Update CONTRIBUTING.md Jun 26, 2018
CodeOfConduct.md Create CodeOfConduct.md Jun 26, 2018
LICENSE.md Rename LICENSE to LICENSE.md Jun 26, 2018
README.md Update README.md Nov 16, 2018
Testing.md Create Testing.md Aug 7, 2018
build.ps1 Add build.ps1 Jun 18, 2018

README.md

Uintra - A social framework

A flexible and lightweight Umbraco based framework, for making an Intranet, Extranet or social platform based on known conventions.

ScreenShot

Why Open Source?

We are trying to create a flexible and robust social framework. We think the best way to achieve this is through an online community, that can share and iterate through ideas. In order to create a solution that has valuable functionality validated by the users.

Getting started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Note: Currently Uintra will not function properly out of the box as a Web application, if you wish guidance to use Uintra as a web application, please contact us.

1. Prerequisites

Before installing Uintra you will have to make certain preparations.

  1. Install MS NET Framework .NET 4.7.1, can be found here.

  2. Install IIS with advanced settings (as seen in the screenshot below) ScreenShot

  3. MSSQLServer with Management Studio. Remember that the version of MSSQL server depends on your Windows version - 32-bit or 64-bit:

    • for latest version MSSQL server you need Windows 64-bit.
    • if you have Windows 32-bit we recommend you to install MSSQL server 2014. Here you can find all files to download and
      install (Express 32BIT WoW64\SQLEXPR32_x86 _ENU and MgmtStudio 32BIT\SQLManagementStudio_x86_ENU).
  4. Visual Studio 2017 with update 15.8.8 or later, can be found here. While installing Visual Studio 2017 you need to choose “ASP.NET and web development” on the Workloads tab: ScreenShot

    and fill in checkboxes “.NET Framework 4.7 SDK”, “.NET Framework 4.7 targeting pack” on the Individual components tab:
    ScreenShot

That is it for the prerequisites now we need to setup the server.

2. Setting up the database server

Using MSSQL Server Management Studio(in administrator mode) we will set up the database(DB) server:

  1. Open your DB server
    ScreenShot

    And add a new user for the login to the DB: ScreenShot

    Set up the server roles for the user: ScreenShot

  2. Create an empty DB
    ScreenShot

    Give it an appropriate name: ScreenShot

  3. Add security options for the server authentication, open properties ScreenShot

    Then go into "Security" and check the box as shown below: ScreenShot

  4. Restart your server
    ScreenShot

  5. Connect with the user you created in step 1 ScreenShot

Now your server is set up and ready for the Uintra installation!

3. Installing Uintra

Installing Uintra Open Visual Studio 2017 that you installed earlier

  1. Create a new project ScreenShot

    Choose “WEB” -> “ASP.NET Web Application(.NET Framework)”. Then choose “NET Framework 4.7.1” and add “Name”, “Location” (data storage on local machine), “Solution name”: ScreenShot

    In the next step choose the “Empty” template and press "OK": ScreenShot

  2. Right click on the new project in the "Solution explorer" block then click on "Manage NuGet packages" ScreenShot

  3. Press "Browse and search for "Uintra" ScreenShot

    Install the latest package version: ScreenShot

  4. Press "OK", "Accept" and “yes to all” in the next popups accept proposals ScreenShot ScreenShot ScreenShot

  5. You should receive a message about 0 errors/warnings ScreenShot

  6. Right click on the new project in the “Solution explorer” block and press “Build” ScreenShot

  7. You should receive a message about a successful installation ScreenShot

With that Uintra is installed, the next and final step is setting up Uintra in IIS and continue the browser configuration.

4. Setting up Uintra

Using the Internet Information Services (IIS) Manager, we are going to add the new website.

  1. Adding the website
    ScreenShot

    Fill in the required fields and create the website: ScreenShot

    NB! The “Physical path” address should be the folder location for the Uintra project you made in Visual Studio 2017(data storage on local machine). In the "Applications Pools" set .NET Framework version 4.0.30319 for your new site.

  2. Add your new site IP-address and name to the “Hosts” file in the windows folder on your computer.

  3. Open your new site in the browser. You’ll be redirected to the “Install Umbraco” page. Fill in all the fields and choose "Customize" ScreenShot

    In the “Database type” dropdown choose Microsoft SQL Server: ScreenShot

    Fill in all the fields. Ensure that the "Server name" and "Database name" is identical with the labels in the MSSQL Server database. Use the credentials for the new user that was created earlier and press "Continue": ScreenShot

    Press "Continue": ScreenShot

    Press the "No thanks, I do not want ...": ScreenShot

    Wait while Umbraco is installed and when it is done you should see the welcoming message: ScreenShot

Now Umbraco is installed.

  1. To administrate your new site, open it in a new tab ScreenShot

    The first login uses the following data: Login - admin, password - qwerty1234 (P.S. We strongly recommend to change this later)

That's all! Now you can open new site based on Uintra and enjoy!

If you are having trouble getting Uintra installed or experience other problems, please contact us at kne@Compent.net, the response time will be very fast within normal business hours, 09-16 CET/CEST.

Elastic Search

If Elastic Search is giving you trouble, please check out the issue https://github.com/Uintra/Uintra/issues/3 that will guide you to setup your elastic search with the proper version. Huge credit to user ChrisAngel447 for spotting this!

Running tests

We have created some simple examples of how to manually test Uintra here.

Contributing to Uintra?

A good way to contribute to Uintra is by providing issue reports. For information on how to submit an issue report refer to our guide to contributing for details on our code of conduct, and information regarding the process for submitting pull requests to us.

Contact

We have several managers and a full team working on Uintra, if you have any questions please send them to our contact person, Kasper at kne@compent.net.

License

This project is licensed under the MIT License - see the file for details.