README

这是一个崇拜服务策划和组织者。

文档和详细信息可以在以下链接找到：http://worshiphhn.org/whhn

此软件旨在在Apache、Maria数据库和PHP环境中运行。一个很好的此类环境是XAMPP。请参阅https://www.apachefriends.org/index.html。然而，Perl不是必需的，但也不会造成任何损害。

您必须选择“压缩文件安装”或“Composer安装”。

压缩文件安装

这可能是大多数人安装的最简单方式。

1. 从https://github.com/thomasdilts/WorshipHHN/releases下载最新版本的压缩文件。
2. 将压缩文件中找到的所有文件安装到您的服务器上。

Composer安装

如果您希望使用Composer安装，则命令为

composer create-project thomasdilts/worshiphhn

安装后步骤

1. 请确保您的服务器具有所有必需的PHP模块，请查看requirements.php页面。以下是我的样子http://worshiphhn.org/whhn/requirements.php
2. 创建一个数据库和用户。以下是如何为您的数据库设置WorshipHHN。
3. 将Example.sql或Empty.sql安装到您的数据库中，以创建所有表和表的启动数据。您可能想先尝试Example.sql，然后稍后安装Empty.sql以从空数据库开始。
4. 您的登录信息为：username=Calum，password=1234AAaa。当然，您希望登录后立即更改这些。

必须更改的文件：_protected/config/db.php 您必须输入您的数据库设置。

<?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 邮件系统必须获取您的SMTP邮件设置：主机、用户名、密码、端口和加密。

        '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
         ],
        ],

您可能还想将 'language' => 'en' 更改为其他内容

_protected/config/params.php adminEmail和senderEmail必须获取有效的电子邮件。您可能希望将showWhhnServerOffer设置为'false'，因为否则您将在WorshipHHN的主页上打印一些不希望的信息。

  'adminEmail' => 'thomas@gmail.com', 
  'senderEmail' => 'thomas@gmail.com',
  'showWhhnServerOffer' => 'true',

如果您想使您的联系屏幕受到“ReCaptcha V3”保护，则需要通过在site_key和secret_key之间放置来自Google的reCAPTCHA3密钥来更改文件_protected/config/web.php。

		'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 
			],	

非常重要的是.htaccess文件。如果您正确安装了压缩文件，则应该已安装了.htaccess文件。但如果有错误，以下是在WorshipHHN安装根目录中必须存在的.htaccess文件。

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

如果您在自己的Linux/Ubuntu类型服务器上安装此软件，则您可能需要在安装根目录中运行以下命令以正确设置所有权。

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