README

WordPress起始模板

这是一个集成了一些其他关于添加Composer到wp和将Foundation集成到wp主题的仓库，旨在简化起始过程。之后，您可以更改composer.json文件来选择您想要的wp插件，但我们使用的是这些插件：

##您可以在以下链接查看演示： http://wp-brixton.oe-lab.tk/

##我们使用以下仓库，并付出了真正的努力：用于Composer安装 https://github.com/roots/bedrock，该仓库使用： https://github.com/johnpbloch/wordpress-core-installer 将插件作为供应商，并使用 https://github.com/vlucas/phpdotenv 来实现美丽的.env配置

##对于我们称之为oe-brixton的Foundation主题，由Ole Fredrik Lie的出色工作。我们使用代码而不是分支来拥有自己的配置，但我会推荐从Ole的仓库中获取最新版本。https://github.com/olefredrik/foundationpress

##对于我们称之为oe-kennington的Bootstrap主题，由Per Thykjaer Jensen的出色工作。我们使用代码而不是分支来拥有自己的实现，但我会推荐从该仓库中克隆最新版本。https://github.com/asathoor/maat-or-the-improved-bootstrap

##在您完成安装后，您可以在以下链接中查看一些正在进行的文档：https://github.com/open-ecommerce/masters-wp/blob/master/docs/working-on-it.md

#如何安装和最终部署：)

安装

在新的文件夹中创建一个新的项目

composer create-project open-ecommerce/masters-wp your-project-folder-name

将.env.example复制到.env并更新环境变量

DB_NAME - 数据库名称
DB_USER - 数据库用户
DB_PASSWORD - 数据库密码
DB_HOST - 数据库主机
WP_ENV - 设置为环境（development、staging、production）
WP_HOME - WordPress主机的完整URL（http://example.com）
WP_SITEURL - 包括子目录的WordPress的完整URL（http://example.com/wp）
AUTH_KEY、SECURE_AUTH_KEY、LOGGED_IN_KEY、NONCE_KEY、AUTH_SALT、SECURE_AUTH_SALT、LOGGED_IN_SALT、NONCE_SALT

如果您想自动生成安全密钥（假设您已在本地上安装了wp-cli），可以使用非常方便的[wp-cli-dotenv-command][wp-cli-dotenv]

  wp package install aaemnnosttv/wp-cli-dotenv-command

  wp dotenv salts regenerate

或者，您可以从[Roots WordPress Salt Generator][roots-wp-salt]中复制并粘贴。

使用您偏好的工具创建本地数据库，我喜欢wp-cli，所以我会运行wp命令，它将使用我们在.env文件中设置的任何数据库凭据：wp db create
将主题添加到web/app/themes中，就像在正常的WordPress网站上添加一样。
将您的网站vhost文档根设置为/path/to/example/web/（如果使用部署，则为/path/to/example/current/web/）

有关web服务器配置的更多信息

访问WP管理界面，地址为：http://example.com/wp/wp-admin

部署方法

有两种方法可以立即部署Bedrock站点。

也可以使用其他部署方法，但有一个要求

必须将composer install作为部署过程的一部分运行。

文档

Bedrock文档可在https://roots.io/bedrock/docs/找到。

现在您需要选择您想要使用的主题，我们在本仓库中放置了2个主题。

###oe-brixton 基于Foundation 4，如我所说，它是从Fredrik的仓库中分叉出来的：https://github.com/olefredrik/foundationpress

这是一个基于Foundation 6的WordPress启动主题，它是世界上最先进、响应式（移动优先）的框架。FoundationPress的目的是作为一个小巧方便的工具箱，其中包含了构建任何设计所需的基本元素。FoundationPress旨在作为一个起点，而不是最终产品。

有关oe-brixton的更多信息

###oe-kennington 基于Bootstrap 4
这个主题是从Maat主题仓库分叉出来的，并针对我们的需求进行了定制。

有关oe-kennington的更多信息

先决条件

您需要在您的盒子上安装带有LAMP（mysql、apache、php等）的WP-CLI。

在您的系统中安装cli

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

其他选项

php -r "readfile('https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar');" > wp-cli.phar

如果您在共享服务器上无法运行curl，只需下载wp-cli.phar并使用ftp上传文件。

然后，您需要使文件可执行。

chmod +x wp-cli.phar

最后一步是将文件移动到文件夹中，这样您就可以从任何地方执行它。将文件重命名为易于记忆和输入的名称也是一个好主意；这也是为什么wp是最常用的名称的原因。

sudo mv wp-cli.phar /usr/local/bin/wp
wp --info

在您的开发箱中使WordPress工作的说明

克隆此仓库的master分支

git clone https://github.com/open-ecommerce/masters-wp.git

（或如果您有ssh密钥，则克隆到ssh地址）

导航到master-wp内的htdocs文件夹

cd masters-wp/htdocs

获取您地区WordPress的最新版本

（从以下网站选择您的地区：http://wpcentral.io/internationalization/）

wp core download --locale=en_GB

安装WordPress，并输入您的数据库凭证

（将'mynewwpdb'更改为您想在MySQL服务器中创建的数据库的名称，以及您自己的凭证）

wp core config --dbname=mynewwpdb --dbuser=root --dbpass=123 --dbhost=localhost --dbprefix=oe34_

根据刚刚创建的wp-config创建数据库（如果您尚未手动创建数据库）

wp db create

安装和配置WordPress

将'myurl.dev'更改为您想要使用的本地URL。
标题只是wp配置内的标题
更改WordPress管理员凭证
在WP-CLI文档中查看更多选项：http://wp-cli.org/commands/core/install/

wp core install --url=myurl.dev  --title="Open-ecommerce wp master" --admin_user=oeadmin --admin_password=Password123
--admin_email="info@open-ecommerce.org"

通过composer安装插件

您可以通过编辑composer.json文件来添加您想要安装的插件。
WordPress插件可在：http://wpackagist.org/找到

composer install

我们在composer.json中添加了："config": { "secure-http": false }，以避免在某些共享服务器中获取http存储库时出现问题。

使用wp-cli激活所有插件

现在您可以进入管理员并激活您想要的WordPress，或者您可以使用此wp-cli命令激活刚刚通过composer安装的所有插件。

wp plugin activate --all

安装测试单元演示数据

我们使用Michael Novotny的wptest仓库，该仓库非常适合测试主题。
在WP-CLI文档中查看更多选项：https://github.com/manovotny/wptest

您可以使用curl从仓库中提取最新版本

curl -OL https://raw.githubusercontent.com/manovotny/wptest/master/wptest.xml

或者使用php readfile

php -r "readfile('https://raw.githubusercontent.com/manovotny/wptest/master/wptest.xml');" > wptest.xml

我还将我们的版本wptest调用oe-dumy-sample添加到这个仓库中，只需进入wp文件夹，使用wp导入所有内容。

wp import wptest.xml --authors=create

或者

wp import oe-dummy-sample.xml --authors=create

然后删除该文件。

rm wptest.xml

将域名添加到您的开发环境中。

如果您使用的是Ubuntu，可以使用文件管理器完成此操作：sudo nautilus
将/docs/myurl.dev.conf复制到/etc/apache2/sites-available并更改域名。
sudo a2ensite myurl.dev.conf
将域名添加到您的/etc/hosts文件中。

此时，您应该已经安装并配置好了wp。

导航到myurl.dev/wp-login
用户：oeadmin
密码：Password123

下一步是构建wp基础主题，您可以在foundationPress仓库中查看完整文档，但这里提醒一下：

进入主题文件夹 /wp-content/themes/oewp
运行npm install（将安装所有grunt模块）
运行'grunt'以监视主题文件夹，并在更改sass文件时编译所有grunt任务

当您在项目上工作时，运行

$ npm run watch

3. 构建所有资源，运行

$ npm run build

构建所有资源，最小化和不生成源图

$ npm run production

关于.htaccess文件

我们从Bob Elison的Gist中使用了此htaccess模板：[链接](https://gist.github.com/wycks/3011895)
您需要根据服务器上安装的模块对其进行调整（如果您使用Apache的话）。

open-ecommerce / masters-wp

维护者

详细信息