BVCMS Developer Quick Start Guide

Copyright (c) 2008-2015 Bellevue Baptist Church Licensed under the GNU General Public License (GPL v2) you may not use this code except in compliance with the License. see LICENSE file in this repository master branch

BVCMS is maintained by TouchPointSoftware, LLC.

IMPORTANT NOTE: The latest version that in production is tagged with a date and time stamp. You can find these under the main Code tab and then under "releases" sub-tab in GitHub There are sub-tabs for commits, branches, releases and contributors.

Install Development Tools and required libraries

1. Visual Studio Community 2017
2. SQL Server Express 2016
3. GitHub for Windows
4. Microsoft URL Rewrite Module 2.0 for IIS 7 (if not already installed)

Clone the Source Code Repository

1. Run GitHub for Windows and follow the setup instructions

   Note: You will need to create an account on GitHub to properly use all of the features

2. Go to the repository in a browser - https://github.com/bvcms/bvcms

3. Click "Clone in Windows" button in the upper left part of the page

   It should request that GitHub use the link, allow it to continue

4. GitHub for Windows should launch and clone the repository to the default location

   The default location for GitHub for Windows is "My Documents\GitHub"

Open the Project

1. Start Visual Studio

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

   Note: If your file extensions are hidden, you will not see the ".sln"

3. Start the Package Manager Console

   Tools > Library Package Manager > Package Manager Console

4. At the top of the Package Manager Console you will see a notification telling you that some packages are missing, click Restore to begin downloading them

5. It should show a progress bar and then disappear when done

6. Edit Web.config under CmsWeb root directory

   • In the appSettings section, configure the dbserver and host values to point to your server and the name of your database (without the CMS_). These two values will become part of your connection string.
   • In the mailSettings, configure the pickupDirectoryLocation to a directory on your development machine (for testing purposes).
   • If you want to create a database with 150 records in it, just use testdb for the host value

7. Right-click on CMSWeb and select Set as StartUp Project

8. Right-click on CMSWeb and select Rebuild. The project should compile successfully

   There will be some warnings, you can ignore them

9. The SQL Server database should be running

10. Click the Play button in the main toolbar to launch BVCMS

11. The first time you start up the system, it will create and populate a starter database

12. Once at the login screen, enter the default username and password and click Log On.

    Default Username: admin

    Default Password: bvcms

13. After successfully logging in, you should set your admin password immediately because the bvcms password is a one-time use password and will no longer work.

Using BVCMS

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

Pull Requests

See Pull Request Guidelines