Skip to content

This topic targets, and was tested with, the Orchard 1.8 release.

  • 本主题针对Orchard 1.8版本进行了测试,并进行了测试。*

This topic shows the steps you need to perform to install Orchard using the .zip file.

本主题显示使用.zip文件安装Orchard时需要执行的步骤。

We will use three different approaches:

我们将使用三种不同的方法:

  • IIS.

  • IIS。 *

  • WebMatrix and IIS Express

  • WebMatrix和IIS Express *

  • Visual Studio and the Visual Studio Development Server.

  • Visual Studio和Visual Studio开发服务器。 *

Note

!注意

If you prefer using the Web Platform Installer, or if you plan to use WebMatrix to develop your site, you may want to see the topic [Installing Orchard](Installing-Orchard), which installs Orchard from the Web Platform Installer and includes WebMatrix in the installation.

Downloading the .zip File

正在下载.zip文件

Navigate to the Releases Section of Orchard in GitHub.

导航到[GitHub中Orchard的Releases部分](https://github.com/OrchardCMS/Orchard/releases)。

You will find two .zip files.

你会发现两个.zip文件。

  • Orchard.Web.1.x.xx.zip : In this file the site has already been built and can be run without additional compilation. It does not includes all the source code.

  • Orchard.Web.1.x.xx.zip:在此文件中,该站点已经构建,无需额外编译即可运行。它不包括所有源代码。 *

  • Orchard.Source.1.x.xx.zip : This file includes the source code. If you plan to develop modules you probably prefer this one. It is easier to use with Visual Studio and you have plenty of source files to see how everything is done.

  • Orchard.Source.1.x.xx.zip:此文件包含源代码。如果你打算开发模块,你可能更喜欢这个。它更容易与Visual Studio一起使用,并且您有大量的源文件来查看所有操作的完成情况。 *

Running the Site Using IIS

使用IIS运行站点

This procedure was tested with a clean installation of Windows 8.1 Enterprise Edition.

  • 此过程已通过Windows 8.1 Enterprise Edition的全新安装进行了测试。*

First let's setup the server. Search for "Add or Remove Programs" in your system. And execute it.

首先让我们设置服务器。在系统中搜索“添加或删除程序”。并执行它。

Click Turn Windows features on or off.

单击打开或关闭Windows功能

Click Internet Information Services and then ASP.NET 4.5. Click OK.

单击 Internet Information Services ,然后单击 ASP.NET 4.5 。单击确定

At this point we recommend rebooting your system. This way you will be sure that all the required services are started from scratch.

此时我们建议您重新启动系统。这样您就可以确保所有必需的服务都是从头开始的。

When the system restarts, download the Orchard.Web.1.x.xx.zip file from here. Extract the .zip file to your Desktop. The extracted folder contains several files and an Orchard folder.

系统重新启动时,从[此处](https://github.com/OrchardCMS/Orchard/releases/latest)下载_Orchard.Web.1.x.xx.zip_文件。将.zip文件解压缩到桌面。解压缩的文件夹包含多个文件和 Orchard 文件夹。

Copy the Orchard Folder to C:\inetpub\wwwroot\.

Orchard 文件夹复制到 C:\ inetpub \ wwwroot \\

In Windows Explorer go inside the Orchard Folder.Let's start with App_Data folder.

在Windows资源管理器中,进入 Orchard * Folder.Let,从 App \ _Data *文件夹开始。

This folder is where Orchard stores site settings. Right-click App_Data folder, click Properties and using the Security tab set modify and read permissions for the IIS_IUSRS user.

此文件夹是Orchard存储站点设置的位置。右键单击 App \ _Data 文件夹,单击属性并使用安全选项卡设置 IIS \ _ _ _ AERS 用户的修改和读取权限。

Then repeat the same procedure for the following folders:

然后对以下文件夹重复相同的过程:

  • Modules. This is required if you want to install modules from the gallery. (We recommend that you remove the read/write permissions for production sites.)

  • Modules。如果要从库中安装模块,则需要这样做。 (我们建议您删除生产站点的读/写权限。) *

  • Themes. This is required if you want to install themes from the gallery. (We recommend that you remove the read/write permissions for production sites.)

  • Themes。如果要从库中安装主题,则必须执行此操作。 (我们建议您删除生产站点的读/写权限。) *

  • Media. This folder is where Orchard stores media files (images, etc.).

  • 媒体。此文件夹是Orchard存储媒体文件(图像等)的位置。 *

Tip: If you want to completely reset an Orchard site configuration to its default settings, you can delete the contents of the App_Data directory. This removes all your custom settings, users, and configuration, as well as any custom data you have added to the site.

提示:如果要将Orchard站点配置完全重置为其默认设置,则可以删除App \ _Data目录的内容。这将删除所有自定义设置,用户和配置,以及您添加到站点的任何自定义数据。

If you delete the contents of the App_Data folder, and if you want to remove custom images that you have added to the site, you can delete the contents of the Media folder as well. The required files will be recreated the next time Orchard is started.

如果删除App \ _Data文件夹的内容,并且要删除已添加到站点的自定义图像,则还可以删除Media文件夹的内容。 Orchard启动时将重新创建所需的文件。

Now you can create your new website. Search your system for Internet Information Services (IIS) Manager, and execute it.

现在您可以创建新网站了。在系统中搜索 Internet信息服务(IIS)管理器,然后执行它。

Click in Default Web Site and stop. This will free port 80 for our site.

单击默认网站停止。这将为我们的网站释放80端口。

Right-click Sites and Add Website.

右键单击站点添加网站

Write your site name and point Physical path to your Orchard folder. Click Ok.

写下您的站点名称并将物理路径指向您的 Orchard 文件夹。点击确定

Click Yes in the warning dialog about two sites using port 80.

在警告对话框中单击使用端口80关于两个站点的

Your website is running now. Click browse to navigate to it.

您的网站现在正在运行。单击浏览以导航到它。

You should see the Orchard setup screen in your browser.

您应该在浏览器中看到Orchard设置屏幕。

Running the Site Using WebMatrix and IIS Express

使用WebMatrix和IIS Express运行站点

Download the Orchard.Web.1.x.xx.zip file from here. Extract the Orchard .zip file to a local folder. Launch WebMatrix, and in the Quick Start screen, click Open and then Folder.

从[here](https://github.com/OrchardCMS/Orchard/releases/latest)下载_Orchard.Web.1.x.xx.zip_文件。将Orchard .zip文件解压缩到本地文件夹。启动WebMatrix,然后在快速启动屏幕中,单击打开,然后单击文件夹

Navigate to the folder where you extracted the .zip file, select the folder named Orchard, and then click Select Folder to open the site.

导航到解压缩.zip文件的文件夹,选择名为 Orchard 的文件夹,然后单击选择文件夹以打开该站点。

To run the site, in the WebMatrix Files workspace, select the root Orchard folder. Click the drop-down list in the Run button and then select a browser.

要运行该站点,请在WebMatrix Files 工作区中,选择root Orchard 文件夹。单击运行按钮中的下拉列表,然后选择一个浏览器。

You should see the Orchard setup screen in your browser.

您应该在浏览器中看到Orchard设置屏幕。

Running the Site Using Visual Studio and the Visual Studio Development Server

使用Visual Studio和Visual Studio开发服务器运行站点

This procedure was tested with Visual Studio 2013 Update 1.

  • 此过程已使用Visual Studio 2013 Update 1进行测试。*

Altough you can run the precompiled version of Orchard in Visual Studio, you will find much easier to work in Visual Studio with the full source code version.

尽管您可以在Visual Studio中运行Orchard的预编译版本,但您会发现在Visual Studio中使用完整的源代码版本更容易。

Download the full source code from here. Extract the .zip file to a local folder.

从[here](https://github.com/OrchardCMS/Orchard/releases/latest)下载完整的源代码。将.zip文件解压缩到本地文件夹。

Launch Visual Studio and select File > Open > Project/Solution. Navigate to the folder where you extracted the .zip and open the folder named src. Select the Orchard.sln solution file.

启动Visual Studio并选择文件> 打开> 项目/解决方案。导航到解压缩.zip的文件夹,然后打开名为 src 的文件夹。选择 Orchard.sln 解决方案文件。

To run the site, press Ctrl+F5. You should see the Orchard setup screen in your browser.

要运行该站点,请按Ctrl + F5。您应该在浏览器中看到Orchard设置屏幕。

Setting Up a Site

设置站点

When you first launch the Orchard site, you are presented with the Orchard setup screen:

首次启动Orchard站点时,将显示Orchard设置屏幕:

By default, Orchard includes a built-in database that you can use without installing a separate database server. If you choose this option then you don't need to configure the database at all. A mini version of SQL Server called SQL Server CE will be automatically run with your site. It keeps its data inside a database file that lives inside App_Data.

默认情况下,Orchard包含一个内置数据库,您无需安装单独的数据库服务器即可使用该数据库。如果选择此选项,则根本不需要配置数据库。 SQL Server CE的迷你版本将自动与您的站点一起运行。它将数据保存在一个位于App_Data内的数据库文件中。

However, if you are running SQL Server or SQL Server Express, you can configure Orchard to use either of those products instead by specifying a connection string. The database and user specified in the connection string must be created before you start the Orchard setup. Just create an empty database on your database server, create the user and that's it. Orchard will set up all of the tables and data automatically for you during the setup process.

但是,如果您运行的是SQL Server或SQL Server Express,则可以通过指定连接字符串将Orchard配置为使用其中任何一种产品。必须在启动Orchard设置之前创建连接字符串中指定的数据库和用户。只需在数据库服务器上创建一个空数据库,创建用户即可。 Orchard将在设置过程中自动为您设置所有表格和数据。

Optionally, you can enter a table prefix so that multiple Orchard installations can share the same database but keep their data separate.

(可选)您可以输入表前缀,以便多个Orchard安装可以共享同一个数据库,但保持其数据分离。

The Orchard setup screen includes a section where you can choose an Orchard recipe. You can choose from the following Orchard recipes:

Orchard设置屏幕包含一个可以选择果园配方的部分。您可以从以下Orchard食谱中进行选择:

  • Default. Sets up a site with frequently used Orchard features.

  • 默认。设置具有常用Orchard功能的站点。

  • Blog. Sets up a site as a personal blog.

  • 博客。将网站设置为个人博客。

  • Core. Sets up a site that has only the Orchard framework for development use.

  • 核心。设置仅具有Orchard框架以供开发使用的站点。

For information about recipes and how to make a custom recipe, see Making a Web Site Recipe.

有关配方以及如何制作自定义配方的信息,请参阅[制作网站配方](http://orchardproject.net/docs/Making-a-Web-Site-Recipe.ashx)。

After you've entered the required information on the setup screen, click Finish Setup. When the setup process is complete, your new site's home page is displayed.

在设置屏幕上输入所需信息后,单击完成设置。设置过程完成后,将显示新站点的主页。

You are now on the Orchard home page and can begin configuring your site.

您现在位于Orchard主页上,可以开始配置您的站点。

Change History

改变历史

  • Updates for Orchard 1.8

  • Orchard 1.8的更新 *

    • 4-9-14: Added screenshots and more detail to the IIS section. Updated Webmatrix screenshots. Changed a bit the structure of some paragraphs to make them clearer. Updated some links.
  • Updates for Orchard 1.6

  • Orchard 1.6的更新 *

    • 11-07-12: Updated screens for 1.6 installation.

    • 4-12-11: Updated screens for 1.1 installation.

  • 4-12-11:更新了1.1安装的屏幕。 *

    • 3-14-11: Added section on using WebMatrix and IIS Express.

    • 3-14-11: Added information about recipes in the setup screen.

    • 3-15-11: Fixed the IIS section to use the Orchard subfolder from the zip.