thomasdilts/worshiphhn

Church service organizer and planner

v1.0.27-stable 2020-01-16 19:10 UTC

Requires

• php: >=5.4.0
• dompdf/dompdf: ^0.8.3
• kartik-v/yii2-password: ^1.5
• kekaadrenalin/yii2-module-recaptcha-v3: *
• nemmo/yii2-attachments: ^1.0@beta
• nex/yii2-datepicker: dev-master
• phpoffice/phpspreadsheet: ^1.8
• thomasdilts/sms_worshiphhn_ip1: ^1.0
• yiisoft/yii2: ~2.0.14
• yiisoft/yii2-bootstrap: ~2.0.0
• yiisoft/yii2-swiftmailer: ~2.0.0 || ~2.1.0

Requires (Dev)

• codeception/base: ~2.3.0
• codeception/specify: ~0.4.6
• codeception/verify: ~0.4.0
• symfony/browser-kit: >=2.7 <=4.2.4
• yiisoft/yii2-debug: ~2.1.0
• yiisoft/yii2-faker: ~2.0.0
• yiisoft/yii2-gii: ~2.1.0

GPL-3.0-or-later

• events
• Organizer
• Planner
• Church

README

A worship service planner and organizer.

Documentation and details can be found at http://worshiphhn.org/whhn

This software is designed to work on an apache, maria database and php environment. A good such environment is XAMPP. see https://www.apachefriends.org/index.html. Perl however is not needed but doesn't harm anything.

You must choose either the "Zip file installation" or the "Composer installation"

Zip file installation

This is probably the easiest way to install for most people.

1. Download the latest version zip file found at https://github.com/thomasdilts/WorshipHHN/releases
2. Install all the files found in the zip file onto your server.

Composer installation

If you wish to install with Composer then the command is:

composer create-project thomasdilts/worshiphhn

Post installation steps

1. Make sure your server has all the PHP modules you need by looking at the requirements.php page. Here is how mine looks http://worshiphhn.org/whhn/requirements.php
2. Create a database and user. See below for how to setup WorshipHHN for your database.
3. Install the Example.sql or the Empty.sql onto your database to create all the tables and a startup of data for the tables. You might want to try Example.sql first and then later install Empty.sql to start with an empty database.
4. Your login will be username=Calum, password=1234AAaa Of course you want to change these as soon as you log in.

Files you must change: _protected/config/db.php You must enter your database settings.

<?php

return [
    'class' => 'yii\db\Connection',
    'dsn' => 'mysql:host=localhost;dbname=YOUR-DATABASE-NAME',
    'username' => 'YOUR-DATABASE-USERNAME',
    'password' => 'YOUR-DATABASE-PASSWORD',
    'charset' => 'utf8',
];

_protected/config/web.php The mail system must get your SMTP mail settings: Host, username, password, port and encryption.

        'mailer' => [
            'class' => 'yii\swiftmailer\Mailer',
            // send all mails to a file by default. 
            // You have to set 'useFileTransport' to false and configure a transport for the mailer to send real emails.
            'useFileTransport' => false,
			'transport' => [
             'class' => 'Swift_SmtpTransport',
             'host' => 'YOUR.HOST',  // e.g. smtp.mandrillapp.com or smtp.gmail.com
             'username' => 'YOUR-USERNAME',
             'password' => 'YOUR-PASSWORD', 
             'port' => '587', // Port 25 is a very common port too
             'encryption' => 'tls', // It is often used, check your provider or mail server specs
         ],
        ],

plus you might want to change 'language' => 'en' to something else

_protected/config/params.php adminEmail and senderEmail must get valid emails. showWhhnServerOffer you might want to set to 'false' because otherwise you will get some unwanted information printed on your home page for WorshipHHN

  'adminEmail' => '[e-mail]', 
  'senderEmail' => '[e-mail]',
  'showWhhnServerOffer' => 'true',

If you want your contact screen to be "ReCaptcha V3" protected then you need to change the file _protected/config/web.php by putting your recaptcha3 keys from google between the quotes for site_key and secret_key.

		'reCaptcha3' => [
				'class'      => 'kekaadrenalin\recaptcha3\ReCaptcha',
				// you must supply your own keys. Get from "google developer recaptcha v3"
				'site_key'   => '', // put YOUR.SITE.KEY.FROM.GOOGLE inside the quotes
				'secret_key' => '', // put YOUR.SECRET.KEY.FROM.GOOGLE inside the quotes 
			],	

Extremely important is the .htaccess file. If you install the zip file correctly the .htaccess file should be installed. But if you make a mistake, below is the .htaccess file that must be in the root of where you installed WorshipHHN

RewriteEngine on

# hide files and folders
RedirectMatch 404 /_protected
RedirectMatch 404 /\.git
RedirectMatch 404 /composer\.
RedirectMatch 404 /.bowerrc

# If a directory or a file exists, use the request directly
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
# Otherwise forward the request to index.php
RewriteRule . index.php

If you are installing this in your own linux/ubuntu type server then you will probably need to run the following command in the root of your installation to get the ownerships correct.

sudo chown -R www-data:www-data *