Parallels Plesk SiteBuilder Administrator’s Guide

Parallels® Plesk Sitebuilder

Copyright Notice

ISBN: N/A
Parallels
660 SW 39th Street
Suite 205
Renton, Washington 98057
USA
Phone: [phone]
Fax: [phone]

© Copyright 1999-2008,
Parallels, Inc.
All rights reserved

Distribution of this work or derivative of this work in any form is prohibited unless prior written

permission is obtained from the copyright holder.

Product and service names mentioned herein are the trademarks of their respective owners.

Contents

Preface 5

About this Guide ............................................................................................................................ 5

Who Should Read this Guide ........................................................................................................ 5

Typographical Conventions ........................................................................................................... 5

Feedback ....................................................................................................................................... 6

About Plesk Sitebuilder 7

Plesk Sitebuilder User Roles ......................................................................................................... 8

Overview of Plesk Sitebuilder Business Logic .............................................................................. 9

What's New in this Version .......................................................................................................... 10

Getting Started 11

Creating First Administrator Account ........................................................................................... 12

Logging In to Plesk Sitebuilder .................................................................................................... 15

Recovering Forgotten Password ....................................................................................... 16

Learning Plesk Sitebuilder Administrator Panel Interface ........................................................... 17

Navigating in Plesk Sitebuilder .......................................................................................... 18

Working with Lists ............................................................................................................. 23

Using Context Help ........................................................................................................... 25

Submitting Feedback on Plesk Sitebuilder Functionality ............................................................ 26

Getting Help ................................................................................................................................. 27

Configuring Settings Related to Your Account 28

Changing Your Password and Personal Information .................................................................. 29

Choosing Language, Skin, and Number of List Items Shown per Page ..................................... 30

Setting Up Global Account .......................................................................................................... 31

Creating Global Account ................................................................................................... 32

Connecting Local Accounts to Your Global Account ........................................................ 33

Switching Between Accounts ............................................................................................ 34

Editing Global Account ...................................................................................................... 35

Disconnecting Local Accounts from Global Account ........................................................ 35

Upgrading Your License .............................................................................................................. 36

Viewing System Information .............................................................................................. 37

Setting Up and Maintaining Plesk Sitebuilder 38

Rebranding Your Plesk Sitebuilder ............................................................................................. 38

Setting Up Logo and Title Bar Text ................................................................................... 39

Customizing Help and Support Links ................................................................................ 40

Setting Up SMTP Server for Sending Notifications from Plesk Sitebuilder ................................. 41

Obtaining Additional Skins, Languages, and Site Design Templates ......................................... 42

Viewing and Configuring Plesk Sitebuilder Wizard Presets and Modules .................................. 43

Managing Site Design Templates ..................................................................................... 44

Managing Site Structure Templates (Page Sets) .............................................................. 45

Managing Site Templates (Site Families) ......................................................................... 51

Managing Modules ............................................................................................................ 56

Updating Plesk Sitebuilder .......................................................................................................... 69

Preface 4

Specifying Hosts Used for Publishing Sites ................................................................................ 70

Requirements to Hosts ...................................................................................................... 72

Adding Host ....................................................................................................................... 75

Specifying Hosts Available to Certain Users ..................................................................... 77

Modifying Host Settings .................................................................................................... 77

Removing Host from List of Available Hosts ..................................................................... 77

Setting Up Plesk Sitebuilder for Anonymous Visits ..................................................................... 78

Setting Up Service Plan for Anonymous Users ................................................................ 79

Setting Language and Skin for Anonymous User Sessions ............................................. 80

Setting Up Advertising Banner Shown on Trial Sites ........................................................ 81

Setting Up Message Displayed at Publish Step of Wizard ............................................... 82

Setting Up Notification Sent at Trial Site Publication Attempt ........................................... 83

Inserting Macros, Links, and HTML Code into Notification Messages ............................. 85

Prohibiting Anonymous Users from Accessing Plesk Sitebuilder Wizard ......................... 87

Viewing Plesk Sitebuilder Logs ................................................................................................... 88

Serving Your Customers 92

Setting Up Service Plans ............................................................................................................. 93

Adding Plan ....................................................................................................................... 95

Assigning Plan to User ...................................................................................................... 99

Modifying Plan ................................................................................................................... 99

Changing Plan Status ..................................................................................................... 100

Removing Plan ................................................................................................................ 100

Signing Up Customers .............................................................................................................. 101

Creating User Account .................................................................................................... 103

Viewing List of Sites Belonging to User .......................................................................... 104

Suspending and Unsuspending User Accounts.............................................................. 104

Upgrading and Downgrading User Accounts .................................................................. 105

Changing User Account Password and Contact Information .......................................... 105

Logging In On Behalf of Your Customers ....................................................................... 105

Removing User Account ................................................................................................. 106

Managing Sites .......................................................................................................................... 107

Registering Site in System .............................................................................................. 109

Assigning Trial Site to Your Account ............................................................................... 112

Renaming Site ................................................................................................................. 113

Changing Site Owner ...................................................................................................... 113

Editing Site Publishing Settings ...................................................................................... 113

Publishing Site................................................................................................................. 114

Creating Your Own Site in Plesk Sitebuilder Wizard ...................................................... 114

Previewing and Editing Site ............................................................................................ 115

Promoting Site and Tracking Site Popularity .................................................................. 115

Removing Site ................................................................................................................. 118

Backing Up and Restoring Your Data 119

Backing Up from Your Administrator Panel ............................................................................... 119

Backing Up from Command Line .............................................................................................. 120

Restoring Plesk Sitebuilder Data ............................................................................................... 121

Preface 5

In this section:

About this Guide ................................................................................................ 5

Who Should Read this Guide ............................................................................ 5

Typographical Conventions ............................................................................... 5

Feedback .......................................................................................................... 6

Formatting Convention

Type of Information

Example

Special Bold

Items you must select,
such as menu options,
command buttons, or items
in a list.

Go to the Hosts tab.
Titles of chapters, sections,

and subsections.

Read the Getting Started chapter.

Preface

About this Guide

This guide instructs you how to set up Plesk Sitebuilder system preferences and manage
and maintain web sites created in Plesk Sitebuilder.

Who Should Read this Guide

This guide is intended for users who manage Plesk Sitebuilder and all its components using
administrator account.

Typographical Conventions

Before you start using this guide, it is important to understand the documentation
conventions used in it.

The following kinds of formatting in the text identify special information.

6 Preface

Italics

Used to emphasize the
importance of a point, to
introduce a term or to
designate a command line
placeholder, which is to be
replaced with a real name
or value.

These types of users are called
Plesk Sitebuilder user roles.

Monospace

URLs, names of
commands, files, and
directories.

For example:

http://[Sitebuilder_host]/Ad
min

CAPITALS

Names of keys on the
keyboard.

SHIFT, CTRL, ALT

KEY+KEY

Key combinations for
which the user must press
and hold down one key
and then press another.

CTRL+P, ALT+F4

Feedback

If you have found a mistake in this guide, or if you have suggestions or ideas on how to
improve this guide, please send your feedback using the online form at

http://www.parallels.com/en/support/usersdoc/. Please include in your report the guide's title,

chapter and section titles, and the fragment of text in which you have found an error.

Plesk Sitebuilder consists of two parts: the Wizard and the Administrator Panel.

In this chapter:

Plesk Sitebuilder User Roles ............................................................................. 8

Overview of Plesk Sitebuilder Business Logic ................................................... 9

What's New in this Version ................................................................................ 10

C H A P T E R 1

About Plesk Sitebuilder

The Wizard is a web application enabling its users to create web sites and publish
them on the Internet.

The Administrator Panel is a tool for managing Plesk Sitebuilder system-wide
preferences and maintaining web sites created in the Wizard.

8 About Plesk Sitebuilder

Plesk Sitebuilder User Roles

In Plesk Sitebuilder, different types of users have different levels of administration
privileges. These types of users are called user roles.

There are three user roles in Plesk Sitebuilder:
1 Administrator manages all Plesk Sitebuilder elements.

Plesk Sitebuilder administrators can perform the following main operations:

 Add and manage hosts, that is servers used for sites publication
 Create and manage plans, that is tariffs regulating the distribution of Plesk

Sitebuilder resources

 Create and manage administrators, resellers, and site owners accounts
 Add and manage sites
 Manage components and settings of Plesk Sitebuilder
 View system and security logs

2 Reseller is a distributor of the Plesk Sitebuilder services.

Plesk Sitebuilder resellers may perform the following main operations:

 Add and manage hosts
 Create and manage plans
 Create and manage resellers and site owners accounts
 Add and manage sites
 Configure system settings

3 Site owner is a user who has purchased the hosting service bundled with Plesk

Sitebuilder. Site owners are registered in Plesk Sitebuilder after they purchase
hosting service and receive their Plesk Sitebuilder credentials (login and password)
upon this purchase. Their main tool is Plesk Sitebuilder Wizard, which is described
in the Parallels Plesk Sitebuilder for Windows Wizard User's Guide
(http://www.parallels.com/en/products/sitebuilder/docs/). Site owners can manage
their own sites only.

Besides, you, as administrator, can make the Plesk Sitebuilder Wizard available for
anonymous visitors, who are, in fact, potential site owners. They can create trial sites in
Plesk Sitebuilder but cannot publish them on the Internet. After anonymous users
create trial sites, they are offered to purchase hosting service to publish their sites on
the Internet. Anonymous user can use the Plesk Sitebuilder Wizard only.

About Plesk Sitebuilder 9

Overview of Plesk Sitebuilder Business
Logic

Below you will find the recommended scenario of getting started with Plesk Sitebuilder.
Read this information to understand the logic of Plesk Sitebuilder application, learn
about its main functionalities and work out the most reasonable and time-saving order
of operations.

Tasks you can perform in Plesk Sitebuilder can be logically divided into the following
categories:

Configuring the Settings of your Administrator Panel and account
At this stage you customize the basic settings of your Plesk Sitebuilder:

 Upgrade your Plesk Sitebuilder license
 Configure your account information
 Choose the language and skin for your interface

Preparing Plesk Sitebuilder for serving your customers

This stage implies several preparatory steps:

 Rebranding Plesk Sitebuilder:

 Uploading the logo and specifying your custom title bar text for the Plesk

Sitebuilder window

 Specifying your custom links for Help and Support buttons

 Configuring Plesk Sitebuilder Wizard presets:

 Site design templates (obtaining additional templates)
 Functional modules (configuring the Area Map module, integrating custom

payment system in the eShop module)

 Site structure templates, or page sets (creating your custom page sets)
 Site templates, or site families (creating your custom site families)

 Preparing publishing host(s) for working with Plesk Sitebuilder and specifying them

in Plesk Sitebuilder system settings.

 Configuring Plesk Sitebuilder settings for anonymous user sessions:

 Creating a special trial service plan for anonymous users
 Setting up the message displayed on the Publish step of the Plesk Sitebuilder

Wizard, the advertising banner to be shown on trial sites, and configuring the
automatic e-mail notification sent to users after the creation of a trial site

Serving your customers
At this stage, you integrate Plesk Sitebuilder into your business process and start

working in it.

10 About Plesk Sitebuilder

 Creating service plans to configure Plesk Sitebuilder limits and permissions for

certain users. In service plans, you also specify the hosts, modules, site families,
page sets, and site design templates available to users.

 Creating user accounts in the system and assigning service plans to them.
 If necessary, registering sites for users.
 If necessary, providing basic site promotion services and monitoring site

performance:

 Register users' sites on Google and MSN search engines.
 Enable and view site attendance statistics.

Backing up and restoring Plesk Sitebuilder
At this stage, you ensure the safety and integrity of your and your customers' data. We

recommend creating Plesk Sitebuilder backups on a regular basis.
The current Administrator's Guide is structured according to this logical order of

operations.

What's New in this Version

Plesk Sitebuilder 4.5 offers the following new features:
 Order New Key button that opens a page on the Parallels Web site where you can

purchase the desired Plesk Sitebuilder license and support option.
Major Features for End-Users
 Site Map module. Allows site owners to display a clickable hierarchical model of their

site structure to visitors
 Removing design template from pages. Site owners can now remove design template's

layout and graphics from the desired pages.
 External Page module. Allows site owners to link site menu items to external web

sites.
 Save button. A handy way for site owners to save changes they make while working

on their site.
 Counter settings are moved to the Wizard. Site owners can now enable a counter on

their sites at the Pages step of the Wizard, which previously required them to go to

the Administrator Panel.
 Site visitor management is moved to the Wizard. Site owners can now manage their

registered visitors through the Registration module editor at the Edit step of the

Wizard, which previously required them to go to the Administrator Panel.

This chapter guides you through the initial steps that should be taken to start using

In this chapter:

Creating First Administrator Account ................................................................. 12

Logging In to Plesk Sitebuilder .......................................................................... 15

Learning Plesk Sitebuilder Administrator Panel Interface .................................. 17

Submitting Feedback on Plesk Sitebuilder Functionality .................................... 26

Getting Help ...................................................................................................... 27

C H A P T E R 2

Getting Started

Plesk Sitebuilder.

12 Getting Started

Creating First Administrator Account

After Plesk Sitebuilder setup, the next step is to create first administrator account that
will allow its owner to log in to the Administrator Panel and start working with it. User
with access to the first administrator account can later create more administrator
accounts to be able to delegate Plesk Sitebuilder management to them, if necessary.
Unlike these later created administrator accounts, the first administrator account cannot
be removed from the system or downgraded to a lower level of user hierarchy.

 To create first administrator account:
1 Click the shortcut to the Plesk Sitebuilder Administration Panel

located on your desktop.

Getting Started 13

Figure 1: Creating Your Administrator Account

2 From the Interface language list, select the language that will be used as

default when you log in to the Administrator Panel.
3 In the Account information section, specify your contact and login

information.
4 In the SMTP server settings section, set up the SMTP server through

which system notification messages will be sent to your e-mail.

14 Getting Started

5 Click Next.

You will be taken to the Desktop page of the Administrator Panel.

Getting Started 15

Logging In to Plesk Sitebuilder

 To log in to Plesk Sitebuilder:

1 In your browser's address bar, enter the URL to your Plesk Sitebuilder

Administrator Panel.

For example, http://sitebuilder:2006/Admin

where 'sitebuilder' is the domain name of the server where your Plesk Sitebuilder is

installed, and '2006' is the port number for connecting to the Plesk Sitebuilder

server.

2 Press ENTER.

Figure 2: Logging In to Plesk Sitebuilder

3 In the User name field, enter your user name.
4 In the Password field, enter your password.
5 From the Interface language list, select the desired language of the Plesk

Sitebuilder interface.
6 Click Log in.

You can change your password at any time (read Changing Your Password and Personal

Information (on page 29)).

16 Getting Started

In this section:

Recovering Forgotten Password ....................................................................... 16

Recovering Forgotten Password

 To recover your forgotten password:

1 In your browser's address bar, enter the URL to your Plesk Sitebuilder

Administrator Panel.

For example, http://sitebuilder:2006/Admin

where 'sitebuilder' is the domain name of the server where your Plesk Sitebuilder is

installed, and '2006' is the port number for connecting to the Plesk Sitebuilder

server.

2 Press ENTER.
3 Click Forgot Your Password.

Figure 3: Recovering Forgotten Password

4 Enter your user name and e-mail address registered in the system.
5 Click Send.

You will receive the e-mail message with instructions how to set up a new

password. Follow the provided URL and type your new password and its

confirmation and click Change. You will be logged in to Plesk Sitebuilder with this

new password.

Getting Started 17

Learning Plesk Sitebuilder Administrator

In this section:

Navigating in Plesk Sitebuilder .......................................................................... 18

Working with Lists ............................................................................................. 23

Using Context Help ........................................................................................... 25

Panel Interface

Read the following section to learn the basic principles of working with Plesk
Sitebuilder interface.

18 Getting Started

Navigating in Plesk Sitebuilder

The Plesk Sitebuilder Administrator Panel interface enables you to use two ways of
navigation through the application: desktop view and standard view.

The standard view is a customary view of the control panel divided into two main areas:
the navigation pane on the left and the work area, where operations are performed, on
the right.

Figure 4: Plesk Sitebuilder Standard View

The desktop view displays system statistics and shortcuts to the main functionalities of
the Administrator Panel.

Getting Started 19

In this section:

Using Navigation Pane ...................................................................................... 20

Using Desktop Interface .................................................................................... 21

Using Path Bar ................................ ................................................................ .. 22

Figure 5: Plesk Sitebuilder Desktop

20 Getting Started

Using Navigation Pane

The navigation pane is located on the left part of the Plesk Sitebuilder screen.

Figure 6: Navigating in Plesk Sitebuilder Using Navigation Pane

The navigation pane gives you access to the following administrative functions:
 Users. Enables you to manage your dependent users and all data related to their

accounts.

 Sites. Enables you to add and manage sites.
 My Profile. Enables you to configure your account parameters.
 Server. Enables you to view and manage various system parameters.
 Logs. Enables you to view and manage logs of operations performed in Plesk

Sitebuilder.
 Log out. Finishes the current session with the Plesk Sitebuilder Administrator

Panel.
 Feedback. Enables you to submit your opinion or suggestions on Plesk

Sitebuilder usability and functionality to Parallels team.

 Support. Enables you to submit a request to Parallels technical support team.
 Help. Provides the context-sensitive online help.

Getting Started 21

Using Desktop Interface

Plesk Sitebuilder Desktop looks as follows:

Figure 7: Navigating in Plesk Sitebuilder Using Desktop Interface

The Desktop screen is logically divided into the following parts:
1 If you have not signed up your Plesk Sitebuilder server to the Google Maps API

service yet, a warning message is displayed at the top of the Desktop screen. You

do not have to sign up for the service immediately - you can do it at any time later

on. For details, read Setting Up Area Map Module (on page 58).
2 Short tips describing basic management options of the Plesk Sitebuilder

Administrator Panel, and shortcuts to these options.

22 Getting Started

3 Shortcut to the Plesk Sitebuilder Wizard. If you have not registered any sites yet,

clicking this link will automatically register a site and will open it in the Wizard. If you

have already registered a site or a number of sites, following this link will open the

Wizard on the Overview page, where you can select which site you want to edit.

Information about working with the Plesk Sitebuilder Wizard is provided in the

Parallels Plesk Sitebuilder for Windows Wizard User's Guide

(http://www.parallels.com/en/products/sitebuilder/docs/).

If you do not want these options to be displayed ever again, click Close at the

bottom right part of the section.
4 Statistics section, which displays the following statistical data:

 Users. The number of created user accounts and the maximum number of user

accounts allowed by your license.

 Sites. The number of sites in the system and the maximum number of sites

allowed by your license.

 Hosts. The number of registered publishing servers and the maximum number of

publishing servers allowed by your license.

5 Tasks section, which contains shortcuts to the main functionalities of the

Administrator Panel.

Using Path Bar

To work with the second-level and deeper-level screens of the application, use a path
bar: a chain of links that appears in the upper-left part of the main application screen.
Use a corresponding path bar link to return to the main screen, or to one of the
intermediate screens.

Figure 8: Navigating in Plesk Sitebuilder Using Path Bar and "Up Level" Button

You can also use the Up Level shortcut in the upper-right corner of the screen to
return to the previous screen.

Getting Started 23

Working with Lists

On the management pages of various system objects (sites, users, etc.), information is
presented in the form of object lists.

In such a list, each object record is a table row displaying the object name, status, and
relevant parameters of the object (for example, for each site, the owner and creation
date is shown). Above and below each list, the total number of items contained in the
list is displayed. Below the list, you can adjust the number of items to be displayed per
page (10, 25 or 100). In multi-page lists, you can navigate between the pages by clicking
the page number shortcuts above and below the list. To go to the first/last page of the
list, click First or Last, accordingly.

To configure the number of items to be displayed per page in all Plesk Sitebuilder lists,
see section Choosing Language, Skin and Number of Items to be Displayed per Page (on page

30).
In lengthy lists, you can find items using the search function, or sort items by one of

available parameters. To find an item, type a search criterion into the input box above
the list, and click Search. The list will show the items matching the search criterion. To
return back to viewing all items, click Show All.

Figure 9: Searching Objects

To sort list items by a certain parameter in ascending or descending order, click the
parameter's title in the column heading. The order of sorting will be indicated by a small
triangle displayed next to the parameter's title.

Figure 10: Sorting Objects

In some lists, you can filter items by a number of additional parameters by selecting
one of such parameters from the View box (for example, on the Sites screen, you can
choose to view My sites, All sites, All trial sites, or My trial sites).

24 Getting Started

Figure 11: Filtering Objects

To choose an object for further operation, select the check box on the left of the
object's name.

Figure 12: Selecting Particular Objects in a List

To choose all objects in the list, select the check box at the head of the column.

Figure 13: Selecting All List Objects at Once

To perform operations with objects in a list, choose the required items and click an
operation shortcut above the list (for example, Delete, Activate, Add to plan, etc.).

Figure 14: Performing Operations on List Objects

To proceed to editing a list item, click its name in the list. For non-editable items (for
example, built-in Plesk Sitebuilder page sets), the item names are not clickable.

In some lists, the status of an object is indicated by an icon in the Status (S) column (
or ). For sites, their status (published or not published), is indicated by or

icons.
For some objects individual operation shortcuts are displayed. For example, for each

site on the Sites screen, there is a Preview icon, a Publish icon, and an Edit
icon.

Getting Started 25

Using Context Help

Below the Help icon, there is a context help area. It provides a brief description of the
current screen and the operations available from it. When you place the mouse pointer
over a system element or status icon, additional information about this element is
displayed.

Figure 15: Using Context Help

26 Getting Started

Submitting Feedback on Plesk Sitebuilder
Functionality

If you would like to share your opinion or suggestions regarding Plesk Sitebuilder
functionality with Parallels team, you can easily submit your feedback through the
Administrator Panel.

 To submit your feedback:
1 On the navigation pane, click Feedback.

Figure 16: Submitting Feedback on Plesk Sitebuilder Functionality

2 From the Type list, specify what kind of feedback you would like to

provide: positive, neutral, or negative.

3 In the Your e-mail field, enter your e-mail address.
4 In the Your message field, type the feedback text.
5 Click Send.

Getting Started 27

Getting Help

If you encounter a problem while using Plesk Sitebuilder, there are several resources
available to help you troubleshoot the problem:

 Use on-screen context-sensitive help.

At the bottom of the navigation pane, you can find short instructions on the

operations that are available on the current page.
 Refer to our knowledge base (http://kb.parallels.com/en/products/sitebuilderwindows).

The knowledge base provides solutions to the most common problems with Plesk

Sitebuilder.
 Go to our forum (http://forum.swsoft.com/forumdisplay.php?f=118).

Here all users can post questions, exchange ideas, and troubleshoot issues not

described in the knowledge base. Note that Parallels does not provide official

support through this forum.
 Contact technical support.

If you have any problems or questions that are not covered in the user

documentation or knowledge base, you can click Support located on the

navigation pane and submit your problem to our Technical Support team.

This chapter describes how to configure your Plesk Sitebuilder account and manage

In this chapter:

Changing Your Password and Personal Information ......................................... 29

Choosing Language, Skin, and Number of List Items Shown per Page ............. 30

Setting Up Global Account ................................................................................ 31

Upgrading Your License .................................................................................... 36

C H A P T E R 3

Configuring Settings Related to Your
Account

your Plesk Sitebuilder license.

Configuring Settings Related to Your Account 29

Changing Your Password and Personal
Information

 To change your password and personal information:

1 On the navigation pane, click My Profile.

Figure 17: Changing Your Password and Personal Information

2 To change your password:

 On the Personal Info tab, click Change Password.

 Type your old and new passwords.

 Click OK.

3 To update your first and last names and e-mail address, configure the

corresponding fields and click OK.

30 Configuring Settings Related to Your Account

Choosing Language, Skin, and Number of
List Items Shown per Page

 To customize your Administrator Panel interface:

1 On the navigation pane, click My Profile.
2 Go to the Interface tab.

Figure 18: Choosing Language, Skin, and Number of List Items Shown per Page

3 From the Language list, select the desired language.
4 From the Skin list, select the desired skin.
5 In the Items per page field, specify the number of items (sites, users, and

so on) to be displayed per one page.

Configuring Settings Related to Your Account 31

Setting Up Global Account

In this section:

Creating Global Account ................................................................................... 32

Connecting Local Accounts to Your Global Account .......................................... 33

Switching Between Accounts ............................................................................ 34

Editing Global Account ...................................................................................... 35

Disconnecting Local Accounts from Global Account .......................................... 35

Global Account is a Single Sign-On technology feature that allows you to log in to
different Parallels products using a single global login and password. If you have
several accounts in Plesk Sitebuilder, you can connect them all to a global account and
switch between these accounts without entering a password every time. You can also
connect all your accounts in other Parallels products to your global account and switch
between them without providing credentials.

After you create a global account and connect local accounts to it, you will be able to
choose from any account connected to your global account when logging in under your
global account.

Single Sign-On technology and the ability to use global accounts can be activated only
through Plesk Sitebuilder API or from Parallels Plesk (if Plesk Sitebuilder is run behind
Plesk).

You can view whether the SSO feature is enabled or not in your Plesk Sitebuilder at
Server > Integration. If SSO is enabled, the URL of the SSO server is also displayed

on the Integration screen.

32 Configuring Settings Related to Your Account

Creating Global Account

 To create a global account:

1 On the navigation pane, click Global Account.
2 Click Connect to Global Account.

Figure 19: Creating Global Account

3 Select Create new global account.
4 Provide the login and password for your global account.
5 Provide an e-mail address to be used for password recovery.
6 Click OK.

Your global account is active now, so you can proceed with connecting other accounts
to it. For more information, refer to Connecting Local Accounts to Your Global Account (on
page 33).

Configuring Settings Related to Your Account 33

Connecting Local Accounts to Your Global Account

 To connect a local Plesk Sitebuilder account to your global account:

1 Log in to Plesk Sitebuilder under the local account you want to

connect.

2 On the navigation pane, click Global Account.
3 Click Connect to Global Account.
4 Make sure that Use existing global account option is selected and provide

the login and password for the global account you want to connect to.

Figure 20: Connecting Local Accounts to Your Global Account

5 Click OK.

Repeat the procedure for other local accounts as necessary.

 To connect an account in another product with SSO support to your global account:
1 Log in to software product with SSO support under the account you

want to connect.
2 Follow the instructions on connecting to a global account in respective

software product documentation. Make sure that you provide the

credentials for the existing global account when you are asked to.

Repeat steps 1-2 for other accounts or products as necessary.

Note: Different software products may use different names for the Global Account
feature, such as Federated Identity or Global Login. Refer to respective software
product documentation for more information.

34 Configuring Settings Related to Your Account

After you have connected all required accounts to your global account, you can log in
under your global account all the time in any product where you have a local account
connected to your global account. You will be shown the list of local accounts
connected to your global account every time you log in under it, so you can choose
which account you would like to use now. You can switch to another account any time
you want. For more information, refer to Switching Between Accounts (on page 34).

Switching Between Accounts

 To switch to another account:

1 On the navigation pane, click Log out.
2 Click Switch User.
3 Select the account you want to switch to:

 Choose the required local account from the list of accounts connected to your

global account
or

 Select Specify another account and provide login and password for a local account

not connected to your global account or to another global account. You can also
select the language for your Administrator Panel from the Interface language list.

Figure 21: Switching Between Accounts

4 Click OK.

Configuring Settings Related to Your Account 35

Editing Global Account

 To edit your global account:

1 Log in to Plesk Sitebuilder under your global account or any local

account connected to it.

2 On the navigation pane, click Global Account.
3 Click Edit Global Account.
4 Enter your old and new passwords.
5 Enter an e-mail address to be used for password recovery.
6 Click OK.

Disconnecting Local Accounts from Global Account

 To disconnect a local account from your global account:

1 Log in to Plesk Sitebuilder under the local account you want to

disconnect.

2 On the navigation pane, click Global Account.
3 Click Disconnect from Global Account.

Figure 22: Disconnecting Local Accounts from Global Account

4 Click OK to confirm the disconnection.

Repeat the procedure for other local accounts as necessary.

36 Configuring Settings Related to Your Account

Upgrading Your License

Plesk Sitebuilder is shipped with a default license that allows creating one site and one
publishing server. Therefore, to fully use the Plesk Sitebuilder as you need, you should
obtain a license key from Parallels or one of its resellers.

Plesk Sitebuilder license keys have a built-in expiration date, so, to keep your license
active, Plesk Sitebuilder will periodically connect to the licensing server and retrieve the
latest license key. This process is run automatically, and the date the next upgrade is

scheduled for is displayed on the License Management screen: Server > License
Management > Product Info tab > License expiration date. You can manually prolong your

current license by clicking Retrieve Keys.

 To upgrade your Plesk Sitebuilder license:

1 On the navigation pane, click Server.
2 Click License Management.

 To upgrade your license to support more sites, click Order New Key.

The Parallels online store will open in a separate browser window. In this
window, select the desired license and click Add to My Basket. In the next steps,
indicate the number of license keys, provide contact details, billing address, and
payment method, and submit the form. The new key will be sent to the specified
e-mail address. Save the new key to the hard drive on your local machine.

 To upgrade your license for larger installations of Plesk Sitebuilder, multi-server

publishing and clustered services, contact Parallels Sales
(mailto:[e-mail]).

After you purchase a license, you will be provided with a license key or
activation code.

3 Open again the License Management screen in Plesk Sitebuilder.

 To upload your license key to Plesk Sitebuilder, click License Key Upload, click

Browse, locate the file with the license key or specify its URL and click Upload.

Figure 23: Uploading Your License Key

Configuring Settings Related to Your Account 37

 To enter your activation code, click Activation Code and input the code you

In this section:

Viewing System Information .............................................................................. 37

received from the sales representative.

Figure 24: Updating Your License Using Activation Code

If after upgrade you wish to restore the default Plesk Sitebuilder license, click

Restore Default License Key.

Viewing System Information

 To view information about the Plesk Sitebuilder program and the limits and

permissions set in your license:

1 On the navigation pane, click Server.
2 Click License Management.
3 Switch between the tabs to view the respective information.

This chapter describes how to set up Plesk Sitebuilder and manage its basic tools.

In this chapter:

Rebranding Your Plesk Sitebuilder .................................................................... 38

Setting Up SMTP Server for Sending Notifications from Plesk Sitebuilder ......... 41

Obtaining Additional Skins, Languages, and Site Design Templates ................. 42

Viewing and Configuring Plesk Sitebuilder Wizard Presets and Modules .......... 43

Updating Plesk Sitebuilder ................................................................................ 69

Specifying Hosts Used for Publishing Sites ....................................................... 70

Setting Up Plesk Sitebuilder for Anonymous Visits ............................................ 78

Viewing Plesk Sitebuilder Logs ......................................................................... 88

In this section:

Setting Up Logo and Title Bar Text .................................................................... 39

Customizing Help and Support Links ................................................................. 40

C H A P T E R 4

Setting Up and Maintaining Plesk
Sitebuilder

Rebranding Your Plesk Sitebuilder

Plesk Sitebuilder allows you to rebrand the application interface according to your
corporate style:

 You can replace the default Plesk Sitebuilder logo with your own one, and make the

logo point to your web site. You can also replace the text displayed in the title bar of

Plesk Sitebuilder interface with your own text - for example, with your company

name. These logo and title bar text will be shown on all pages of the Plesk

Sitebuilder Wizard, to regular and anonymous users, and in all dependent users'

Administrator Panels.
 You can customize the link attached to the Help button and the e-mail address

attached to the Support button in the Administrator Panel and in the Wizard.

Setting Up and Maintaining Plesk Sitebuilder 39

Setting Up Logo and Title Bar Text

 To set up your logo:

1 On the navigation pane, click Server.
2 Click Branding.

Figure 25: Customizing Application Logo and Title Bar Text

3 Click Browse and locate the file with your new logo. Click Open.
4 Click Upload to load the image to the server.

Note: Logo image files must have one of the following formats: *.jpeg, *.jpg, *.gif, or

*.png

5 To make the logo a link to a web site, enter the desired URL in the

Link field.
6 Click OK.

 To set a new text in the browser's title bar:

1 Type the new title in the Title field.
2 Click OK.

You can always restore the default logo, title, and link by clicking Restore Default Settings.

40 Setting Up and Maintaining Plesk Sitebuilder

Customizing Help and Support Links

 To customize help and support links:

1 On the navigation pane, click Server.
2 Click Branding.
3 Go to the Help & Support Links tab.

Figure 26: Customizing Help and Support Links

4 In the Help area, customize the links to the online help for different

user roles as desired.
5 In the Support link field, enter the e-mail address to which users'

support requests should be sent. When a user clicks the Support

button, a mail program on their computer opens a "Compose New

Message" window with this e-mail address specified as the recipient

address.

6 Click OK.

Setting Up and Maintaining Plesk Sitebuilder 41

Setting Up SMTP Server for Sending
Notifications from Plesk Sitebuilder

 To set up the SMTP server for sending e-mail notifications from Plesk Sitebuilder:

1 On the navigation pane, click Server.
2 Click SMTP Server Settings.

Figure 27: Setting Up SMTP Server for Sending Notifications from Plesk Sitebuilder

3 In the SMTP server host field, enter the domain name of the SMTP

server.
4 In the SMTP server port field, enter the number of port for connection to

the SMTP server.
5 In the SMTP server from address field, enter an e-mail address that will be

displayed in the 'From' field of the notification e-mail.
6 If the SMTP server is password protected, click Change Password and

provide the credentials.

7 Click OK.

42 Setting Up and Maintaining Plesk Sitebuilder

Obtaining Additional Skins, Languages,
and Site Design Templates

Plesk Sitebuilder is shipped with a default set of skins, site design templates, and one
language pack (English). If you want to have extra templates, languages, or skins for
your Plesk Sitebuilder, you can install them additionally. To obtain these extra
components, you can:

 Download them from the Parallels web site

(http://www.parallels.com/en/download/sitebuilder/) (excepting skins)
 Create them yourself using Parallels Plesk Sitebuilder Software Development Kit

(for more details, visit Parallels Developer Network

(http://swdn.swsoft.com/en/download/sdk/) and read the Plesk Sitebuilder SDK

documentation)

 Obtain them from a third party

 To view the currently installed components:

 To view the list of available skins, go to Server > Skins
 To view the list of available languages, go to Server > Languages
 To view the list of available templates, go to Server > Templates

To find out about available third-party language packs (if any), or share useful
information on localization issues, visit Parallels Localization forum
(http://forum.swsoft.com/forumdisplay.php?s=&forumid=207).

Setting Up and Maintaining Plesk Sitebuilder 43

Viewing and Configuring Plesk Sitebuilder
Wizard Presets and Modules

Plesk Sitebuilder is shipped with a number of built-in site development presets
(templates intended to facilitate the site creation process in the Plesk Sitebuilder
Wizard) and modules (components which extend site functionality (Blog, Guestbook,
eShop, etc.)).

Set of modules you have at your disposal is regulated by your license. Which modules
will be available to your dependent users you define in their service plans. Creating or
integrating custom Plesk Sitebuilder modules is not supported.

Site development templates can be divided into three types:
 Design Templates. These are ready graphic design solutions developed for certain

categories of web sites (Personal, Art and Photography, Business, etc.). Your users

can apply one of these templates to their web sites on the Design step of the Plesk

Sitebuilder Wizard and then tweak it according to their preferences by choosing a

color scheme, page banner, menu style, and other parameters. Custom design

templates cannot be created through the Plesk Sitebuilder interface, but it is

possible to develop them using Parallels Plesk Sitebuilder Software Development

Kit (for more details, visit Parallels Developer Network

(http://swdn.swsoft.com/en/download/sdk/) and read Plesk Sitebuilder SDK

documentation). Also, you can download additional design templates from the

Parallels web site (http://www.parallels.com/en/download/sitebuilder/).
 Site Structure Templates (page sets). These are pre-defined site structures,

common for sites devoted to a certain subject. For example, a personal site usually

consists of the following pages: Home page, About Myself page, My Family page,

Photos, and so on. Your users can choose one of these page sets and adjust it to

their needs on the Pages step of the Plesk Sitebuilder Wizard. If it is allowed by your

license, you can create your own pages sets in Plesk Sitebuilder and provide them

to your users.
 Site Templates (site families). A site family is a template of a larger scale: a

combination of a design template and a page set. If it is allowed by your license,

you can create your own site families in Plesk Sitebuilder and provide them to your

users. These site templates are offered to your users on the Start page of the Plesk

Sitebuilder Wizard. The choice of a site family determines

 the choice of a default design template on the Design step

 the choice of a default page set offered on the Pages step of Plesk Sitebuilder

Wizard.

On each respective step, your users can choose any other design template or page

set instead of the default ones.

44 Setting Up and Maintaining Plesk Sitebuilder

In this section:

Managing Site Design Templates ...................................................................... 44

Managing Site Structure Templates (Page Sets) ............................................... 45

Managing Site Templates (Site Families) .......................................................... 51

Managing Modules ............................................................................................ 56

Managing Site Design Templates

A design template is a ready graphic design solution developed for certain categories
of web sites (Personal, Art and Photography, Business, etc.). Your users can apply one
of these templates to their web sites on the Design step of the Plesk Sitebuilder Wizard
and then tweak it according to their preferences by choosing a color scheme, page
banner, logo, and menu style.

Custom design templates cannot be created through the Plesk Sitebuilder interface,
but it is possible to develop them using Parallels Plesk Sitebuilder Software
Development Kit (for more details, visit Parallels Developer Network
(http://swdn.swsoft.com/en/download/sdk/) and read Plesk Sitebuilder SDK
documentation). Also, you can download additional design templates from the Parallels
web site (http://www.parallels.com/en/download/sitebuilder/) and install them as
described in the Plesk Sitebuilder for Windows Installation Guide
(http://www.parallels.com/en/products/sitebuilder/docs).

To view available site design templates, go to Server > Templates.
For information on how to operate with list objects, see Working with Lists (on page 23).

 To specify design templates available to certain users:

1 Create a special service plan for these users as described in Adding

Plan (on page 95) - or edit an existing plan (which may be already

assigned to some users) as described in Modifying Plan (on page 99).

2 In this plan, on the Templates tab, select the design templates you want

to hide, and click Remove from plan.
3 On the same tab, select the design templates you want to provide to

users, and click Add to plan.

4 Assign the respective users to this plan as described in Assigning Plan to

User (on page 99).

To specify available templates for anonymous users, make respective changes in the
trial plan. For details about trial plans, see Setting Up Service Plan for Anonymous Users (on

page 79).

Setting Up and Maintaining Plesk Sitebuilder 45

Managing Site Structure Templates (Page Sets)

A page set is a pre-defined site structure, common for sites devoted to a certain
subject. Your users can choose one of these page sets and adjust it to their needs on
the Pages step of the Plesk Sitebuilder Wizard. Plesk Sitebuilder is shipped with a
number of built-in page sets, which you cannot edit or remove from Plesk Sitebuilder,
but if it is allowed by your license, you can create your own page sets either on the basis
of existing Plesk Sitebuilder page sets (see page 47) or from scratch (see page 49). Learn
about the types of single pages offered by Plesk Sitebuilder in Types of Pages (see page

46). You also have an option of configuring the list of available page sets for certain users
(see page 50).

To view the list of available page sets, go to Server > Page Sets. Pages contained
in each page set are enumerated in the Pages column of the list.

For information on how to operate with list objects, see Working with Lists (on page 23).

Figure 28: Page Sets Management Screen

46 Setting Up and Maintaining Plesk Sitebuilder

In this section:

Types of Pages ................................................................................................. 46

Creating Page Set Using Existing One as Template .......................................... 47

Creating Page Set from Scratch ........................................................................ 49

Editing Page Set ............................................................................................... 49

Specifying Page Sets Available to Certain Users .............................................. 50

Removing Page Set .......................................................................................... 50

Types of Pages

When creating a page set, you can use the following types of pages:
 Standard (common) pages - ordinary HTML pages where site owners can insert

text, graphics, etc. Such pages are marked with icons in the site map.
 Special pages - page modules which extend the site functionality. Each module is

designed for a certain purpose and is identified by its own icon. There are the

following types of page modules in Plesk Sitebuilder:

 Blog. Supports a standard set of blog functionality: posting, commenting,

content categorizing, etc. A Blog page is very convenient for organizing the
News, Events and similar pages on sites.

 Image Gallery. Allows you to share images or photos online. Supports batch

image upload with group editing functions, organizing images into albums, etc.

 File Download. Allows providing content for download to site visitors.

 eShop. Online store creation and management tool featuring shopping cart,

multi-currency, categorized product catalog with thumbnail upload capability,
product inventory and shipping cost support, order management. Provides
integration with 5 online payment gateways, including PayPal, Authorize.Net,
2Checkout.com, WorldPay, and BluePay, and allows to integrate one custom
payment system of your choice.

 Flash Intro. A pre-designed flash introduction to your site. It is possible to

choose between several designs of the intro and insert custom text information
into it.

 Guestbook. Allows you to create a guestbook and manage the posted

messages.

 Forum. Allows you to set up a forum where visitors can post questions and

participate in discussions.

 Registration. Allows you to set up voluntary user authentication on sites. After

a registered site visitor opts in, their details are automatically inputted in all
forms they open on the site, for example, when submitting a forum topic or
shopping at the online store. You can suspend a visitor account, thus restricting
a visitor from authenticating under his or her user name.

 External Page. Allows incorporating links to external pages into the site menu.
The list of available modules is determined by your license.

Setting Up and Maintaining Plesk Sitebuilder 47

Creating Page Set Using Existing One as Template

 To create a page set on the basis of an existing page set:

1 On the navigation pane, click Server.
2 Click Page Sets.
3 In the list of available page sets, click the Clone icon against the

page set you want to take as a basis.

Figure 29: Creating a Page Set: Adding Pages

4 In the Code field, provide a code for the page set.

Code is used for identifying page sets in Plesk Sitebuilder. It can be any arbitrary

text, but it must be unique for every page set.

5 In the Title field, specify a name for the page set.

The page set appears under this name in the list of available page sets at the Pages

step of the Wizard.

6 To add a page to the page set, select it in the Special pages box and

click Add.

7 To move a page up or down at the same level, select it in the Page set

structure box and click Up or Down respectively.

48 Setting Up and Maintaining Plesk Sitebuilder

8 To move a page from the second level to the top level, select it in the

Page set structure box and click Left.

9 To move a page from the top level to the second level, select it in the

Page set structure box and click Right.

10 To remove a page from the page set, select it and click Delete.
11 To edit the title and content of a page, click its name in the Page set

structure box.

The page settings will be available for editing in the Page info area.

12 Click OK.

Figure 30: Creating a Page Set: Setting Up Pages

Setting Up and Maintaining Plesk Sitebuilder 49

Creating Page Set from Scratch

 To create a page set from scratch:

1 On the navigation pane, click Server.
2 Click Page Sets.
3 Click Add New Page Set.
4 In the Code field, provide a code for the page set.

Code is used for identifying page sets in Plesk Sitebuilder. It can be any arbitrary

text, but it must be unique for every page set.

5 In the Title field, specify a name for the page set.

The page set appears under this name in the list of available page sets at the Pages

step of the Wizard.

6 To add a page to the page set, select it in the Special pages box and

click Add.

7 To move a page up or down at the same level, select it in the Page set

structure box and click Up or Down respectively.

8 To move a page from the second level to the top level, select it in the

Page set structure box and click Left.

9 To move a page from the top level to the second level, select it in the

Page set structure box and click Right.

10 To remove a page from the page set, select it in the Page set structure

area and click Delete.

11 To edit the title and content of a page, click its name in the Page set

structure box.

The page settings will be available for editing in the Page info area.

12 Click OK.

Editing Page Set

You can edit only custom page sets.

 To edit a page set:

1 On the navigation pane, click Server.
2 Click Page Sets.
3 In the Code column, click the code of the page set you want to edit.
4 Make necessary changes.
5 Click OK.

50 Setting Up and Maintaining Plesk Sitebuilder

Specifying Page Sets Available to Certain Users

By default, all page sets already existing in your Plesk Sitebuilder are included in all
newly created service plans and therefore become available to all users these plans
are assigned to. When you create a custom page set, it is not automatically added to
the existing plans, so to serve newly created page sets out to your customers, you
should add them to the list of available page sets in the corresponding plans (see page 95). If
you do not want a page set to be available to a customer, you just exclude it from the
customer’s service plan.

 To specify page sets available to certain users:

1 Create a special service plan for these users as described in Adding

Plan (on page 95) - or edit an existing plan (which may be already

assigned to some users) as described in Modifying Plan (on page 99).

2 In the plan editor

 Go to the Page Sets tab, select the page sets you want to hide and click

Remove from plan.

 On the same tab, select the page sets you wish to include in the plan, and click

Add to plan.

3 Assign all respective users to this plan as described in Assigning Plan to

User (on page 99).

To configure page sets available to anonymous users, make the respective changes in
the trial plan. For details about trial plans, refer to Setting Up Service Plan for Anonymous

Users (on page 79).

Removing Page Set

Note that you cannot delete built-in Plesk Sitebuilder page sets or the only available
page set in any of Plesk Sitebuilder plans.

After you delete a custom page set, it is removed permanently from Plesk Sitebuilder
and cannot be recovered.

Sites already created using the removed page set are not affected.

 To remove a page set:

1 On the navigation pane, click Server.
2 Click Page Sets.
3 Select the page set you want to remove and click Delete.

Setting Up and Maintaining Plesk Sitebuilder 51

Managing Site Templates (Site Families)

In this section:

Creating Site Family .......................................................................................... 52

Editing Site Family............................................................................................. 53

Specifying Site Families Available to Certain Users........................................... 54

Setting Default Site Family ................................................................................ 55

Removing Site Family ....................................................................................... 55

A site family is a site template comprised of a design template and a page set. These
site templates are offered to your users on the Start page of the Plesk Sitebuilder
Wizard. Users will always be able to choose another design template or page set
instead of the default ones proposed by the site family.

Plesk Sitebuilder is shipped with a number of built-in site families, which you cannot
edit or remove from Plesk Sitebuilder. But if it is allowed by your license, you can
create your own site families and offer them to your users. You also have an option of
specifying site families available to certain users (see page 54).

To view the list of available site families, go to Server > Site Families.
For information on how to operate with list objects, see Working with Lists (on page 23).

Figure 31: Site Families Management Sreen

52 Setting Up and Maintaining Plesk Sitebuilder

Creating Site Family

 To create a site family:

1 On the navigation pane, click Server.
2 Click Site Families.
3 Click Add New Site Family.

Figure 32: Creating a Site Family: Configuring the Appearance

4 On the Appearance tab, provide a code for the site family in the Code

field.

Code is used for identifying site families in Plesk Sitebuilder. It can be any arbitrary

text, but it must be unique for every site family.

5 In the Title field, specify a name for the site family.

The site family is displayed under this name in the list of site types on the Start page

of the Wizard.

6 If you want to provide a description of the site family, enter a

description text in the Description area.

Setting Up and Maintaining Plesk Sitebuilder 53

This description is displayed to the right of the site family name on the Start page of

the Wizard.

7 If you want to add an image to be displayed beside the site family

name, upload an image file from your computer.

You can preview the uploaded image in the Image preview area.

Note: Image size must be 147x90 px. It must be in one of the following formats:

*.jpeg, *.jpg, *.gif, or *.png.

8 Click the Generic tab.

9 From the Template category list, select a template category to be

included in the new site family.
10 From the Page set list, select a page set to be included in the new site

family.

11 Click OK.

Editing Site Family

You can edit only your custom site families.

 To edit a site family:

1 On the navigation pane, click Server.
2 Click Site Families.
3 Click the site family you want to modify.
4 Make necessary changes.
5 Click OK.

Web sites already created using this site family are not affected.

54 Setting Up and Maintaining Plesk Sitebuilder

Specifying Site Families Available to Certain Users

By default, all site families already existing in your Plesk Sitebuilder are included in all
newly created service plans and therefore become available to all users these plans
are assigned to. When you create a custom site family, it is not automatically added to
the existing plans, so to serve newly created site families out to your customers, you
should add them to the list of available site families in the corresponding plans (see page 95).
If you do not want a site family to be available to a customer, you just exclude it from
the customer’s service plan.

 To specify site families available to certain users:

1 Create a special service plan for these users as described in Adding

Plan (on page 95) - or edit an existing plan (which may be already

assigned to some users) as described in Modifying Plan (on page 99).

2 On the Site Families tab, select the site families you want to make

unavailable and click Remove from plan.
3 On the same tab, select the site families you wish to include in the

plan, and click Add to plan.

When including a site family into a plan, make sure that the page set and at least

one design template from the appropriate category which constitute the site family

are included in the plan. If this condition is not met, the site family cannot be

included in the plan.

You can exclude all site families from the plan, except the one you set as a default

one for this plan. The default site family is highlighted in color on the Site Families tab

of the plan editor. For details about changing the default site family, refer to Setting

Default Site Family (on page 55).

4 Click OK.
5 Assign all respective users to this plan as described in Assigning Plan to

User (on page 99).

If you wish to configure the site families available to anonymous users, make the
respective changes in the trial plan. For details about trial plans, refer to Setting Up
Service Plan for Anonymous Users (on page 79).

If you wish to completely replace the existing site families with your custom ones for
certain users, add your custom site families to the respective plan, set one of your
custom site families as a default site family, and remove all built-in Plesk Sitebuilder
site families from the plan.

Setting Up and Maintaining Plesk Sitebuilder 55

Setting Default Site Family

A default site family is a site family which is selected by default when a user comes to
the Start page of the Wizard. Every plan must contain one default site family (which can
be removed neither from plan, nor from the list of created site families).

 To set a default site family for certain users:

1 From the navigation pane, go to Users > Plans.
2 Click the name of the corresponding plan in the list of plans on the

Plans page.
3 On the Site Families tab, select the required site family and click Set as

Default.
4 Click OK.

Removing Site Family

Note that you cannot delete built-in Plesk Sitebuilder site families, default site family, or
the only available site family in any of Plesk Sitebuilder plans.

After you delete a custom site family, it is removed permanently from Plesk Sitebuilder,
and cannot be recovered.

Sites already created using the removed site family are not affected.

 To remove a site family:

1 On the navigation pane, click Server.
2 Click Site Families.
3 Select the site family you want to remove and click Delete.

56 Setting Up and Maintaining Plesk Sitebuilder

Managing Modules

Plesk Sitebuilder modules are components which extend the site functionality: Blog,
Guestbook, eShop, etc. The set of site modules you have at your disposal is regulated
by your license. Which modules will be available to your dependent users you define in
their service plans. Creating or integrating custom Plesk Sitebuilder modules is not
supported.

To view a list of available modules, go to Server > Modules.
For information on how to operate with list objects, refer to section Working with Lists (on

page 23).

Figure 33: Modules Management Screen

On the Modules screen, the following information about modules is available:

 Title. The name under which a module is displayed to the Wizard users.
 Level. The type of a module. Currently, there are three module types:

 Block module is embedded in the body of a page as a functional block (for

example, Feedback Form).

 Page module is a web page added to site structure as a separate section (for

example, Forum).

Setting Up and Maintaining Plesk Sitebuilder 57

 Site module adds a functionality to a site as a whole (is not visible in the site

In this section:

Specifying Modules Available to Certain Users ................................................. 57

Setting Up Area Map Module ............................................................................ 58

Setting Up Site Pal Module ................................................................................ 59

Setting Up eShop Module.................................................................................. 60

structure). For example - Web Statistics module, which allows site owners to
monitor visitor attendance statistics.

 Version. The version of a module.

Specifying Modules Available to Certain Users

By default, all modules that go with your license are included in all created service
plans and therefore become available to all users these plans are assigned to. To
customize the list of modules available to a certain customer, you should add/remove
the desired modules to/from the customer's service plan.

 To specify modules available to certain users:

1 Create a special service plan for these users as described in Adding

Plan (on page 95) - or edit an existing plan (which may be already

assigned to some users) as described in Modifying Plan (on page 99).

2 On the Modules tab, select the modules you want to make unavailable

and click Remove from plan. On the same tab, select the modules you

wish to include in the plan, and click Add to plan.

3 Click OK.
4 Assign all respective users to this plan as described in Assigning Plan to

User (on page 99).

To specify modules available to anonymous users, make respective changes in the trial
plan. For details about trial plans, see Setting Up Service Plan for Anonymous Users (on
page 79).

58 Setting Up and Maintaining Plesk Sitebuilder

Setting Up Area Map Module

The Area Map module allows site owners to insert fragments of geographical maps into
their site pages.

Site owners can choose between two mapping service providers: Google Maps (free­of-charge) or Microsoft MapPoint (account must be purchased). The Microsoft
MapPoint Web Service is configured by site owners in the Plesk Sitebuilder Wizard.

As for the Google Maps API service, to make it available to the site owners in the Area
Map module, you need to get a Google Maps API key for your Plesk Sitebuilder server.
Site owners, in their turn, should get Google Maps API keys particularly for each site to
make the embedded maps available to their site visitors.

Note: After an anonymous user purchases a Plesk Sitebuilder account and publishes
the site, he or she will need to re-generate the Google Maps API key for the new site
URL.

 To enable the Google Maps API service for your Plesk Sitebuilder server:

1 On the navigation pane, click Server.
2 Click Modules.
3 In the list of modules, click Area Map.

4 Click Sign up for a Google Maps API key.
5 On the Google web site, perform the steps required to generate a

Google Maps API key.

In the 'My web site URL' field, you type the URL at which your Plesk Sitebuilder

server is accessible to your customers.

6 Copy the generated Google Maps API key to clipboard and then paste

it into the Google Maps API key field on the Area Map screen.
7 To make sure that the key you specified is valid (that is, it

corresponds to the URL of your Plesk Sitebuilder server), click Verify

Key.
8 Click OK.

Figure 34: Setting Up Area Map Module

Setting Up and Maintaining Plesk Sitebuilder 59

Setting Up Site Pal Module

With the help of the SitePal module, your site owners can add SitePal speaking animated
characters (http://www.sitepal.com) to their web sites, to enrich site visitor experience

and increase sales.
You have an option of registering an affiliate account with Oddcast, Inc. (the owner of

the SitePal trademark), which would allow you to earn commissions from each SitePal
character purchased by site owners through your Plesk Sitebuilder. By default, all
commissions from your SitePal sales are paid to Parallels, as Oddcast general partner.
After you register an affiliate account with Oddcast, the commissions are shared
between you and Parallels. You can initiate affiliate account setup directly from your
Administrator Panel.

 To set up a SitePal affiliate account:

1 On the navigation pane, click Server.
2 On the Server screen, click Modules.
3 In the list of modules, click SitePal.

Figure 35: Setting Up Site Pal Module

4 Specify your first name, last name and e-mail address.

Note: The e-mail address you specify in the Administrator Panel is used as your

SitePal account login. Therefore, editing your e-mail address in the Administrator

Panel will result in losing your existing account and the record of all its earned

commissions, and creating a new account.

5 Click OK.

A confirmation e-mail is sent to the specified e-mail address. In this e-mail, you will

find a link by which you can activate your account, and the credentials (your login

and an automatically generated password) for logging in to your account on the

Oddcast server.

6 Click the account activation link provided in the confirmation e-mail.
7 Log in to your affiliate account using the provided credentials.

Once logged in to your account, you may:

60 Setting Up and Maintaining Plesk Sitebuilder

 Edit your account information and download tax ID forms (This can be found

In this section:

Specifying Payment Systems Available to E-Shop Owners ............................... 61

Setting Up BluePay Affiliate Account ................................................................. 63

Integrating Custom Payment System ................................................................ 65

under the 'Account Info' tab)

 Get SitePal banners to place on your site (This can be found under the

'Banners' tab)

 Monitor sales made via these banners and commissions you have earned from

the sales (This can be found under the 'Reports' tab)

8 Go to the Account Info tab and click Edit to proceed to setting up your

created account.

For instructions on managing your SitePal affiliate account, refer to the Oddcast

Affiliate Program User's Guide

(https://www.oddcast.com/affiliates/docs/Affiliate_UserGuide.pdf).
If later you wish to update your first name, last name or the e-mail specified for your

SitePal affiliate account, make sure to update them in your Administrator Panel. If you
update them on the Oddcast server first, you will receive authorization errors in the
Wizard, and to continue working with SitePal through Plesk Sitebuilder, you will need to
register a new SitePal account from your Administrator Panel. In this case, the record
of commissions earned through your previous account will be lost.

Setting Up eShop Module

The eShop module enables site owners to set up online stores on their web sites,
allowing them to sell products and accept payments online. The current section tells
you how to configure the payment system settings of the eShop module in your
Administrator Panel.

Setting Up and Maintaining Plesk Sitebuilder 61

Specifying Payment Systems Available to E-Shop Owners

In your Administrator Panel, you can select which payment systems will be available to
your online store owners. By default, all payment systems are enabled.

 To specify payment systems available to online store owners:

1 On the navigation pane, click Server.
2 On the Server screen, click Modules.
3 In the list of modules, click eShop.
4 On the eShop screen, go to the Payment Systems tab.

Figure 36: Specifying Payment Systems Available to E-Shop Owners

5 Disable/enable desired payment system by selecting the check boxes

next to their names.

62 Setting Up and Maintaining Plesk Sitebuilder

6 Click OK.

The selected payment systems appear on the Payment Systems tab on the eShop

module settings in the Plesk Sitebuilder Wizard.
For information on configuring additional settings for the BluePay payment system,

refer to Setting Up BluePay Affiliate Account (on page 63).

Setting Up and Maintaining Plesk Sitebuilder 63

Setting Up BluePay Affiliate Account

The eShop module is integrated with a built-in form for registering BluePay merchant
accounts by e-shop owners directly from the Plesk Sitebuilder Wizard. You can enable
or disable this option. Besides, you can register an affiliate account with BluePay,
which would allow you to earn a commission each time a merchant account is
registered from your Plesk Sitebuilder. The revenue generated from newly registered
merchant accounts will be shared between you and Parallels according to your
selected pricing plan.

Your resellers also have an option to enable built-in BluePay registration for their site
owners, and to register their own BluePay affiliate accounts.

 To set up a BluePay affiliate account:

1 On the navigation pane, click Server.
2 Click Modules.
3 Click eShop.
4 Go to the Payment Systems tab.
5 Select the Enable built-in merchant account registration for e-shop owners check

box.

Figure 37: Setting Up BluePay Affiliate Account

6 Click the link Do not have a BluePay affiliate account yet? in the BluePay

section of the screen.

7 Fill in the appeared form and click OK.

64 Setting Up and Maintaining Plesk Sitebuilder

8 Your posted data will be sent to the BluePay representative.
9 The BluePay representative will send the affiliate paperwork to you.
10 Once the signed paperwork is returned to the representative, your

affiliate account will be created and you will be supplied with a user

name and password (a temporary password will be sent to you in a

separate e-mail) for logging in to the BluePay Portal Site

(https://portal.bluepay.com).
11 If you express interest in using the Merchant API to submit

merchants, you will receive this credentials as well:

 API Account ID
 Secret Key
 Agent Online Application ID

12 Specify these parameters in the corresponding fields in the BluePay

section of the screen.
13 Click OK.

Alternatively, you can place a URL to the BluePay Online Application on your site. The
URL is available by clicking the OnlineApp Weblink menu option on the left hand side
when logged into the BluePay Portal Site. This URL contains a unique identifier, so
that BluePay could track which affiliate brought in the deal.

Setting Up and Maintaining Plesk Sitebuilder 65

Integrating Custom Payment System

Plesk Sitebuilder eShop module supports the following online payment systems:

 PayPal
 Authorize.Net
 2Checkout.com
 BluePay
 WorldPay

Plesk Sitebuilder administrators and resellers can integrate the eShop module with one
custom payment system. This can be a custom developed payment system or some
third-party provider's one. To integrate Plesk Sitebuilder with a payment system, you
need a proxy web application that will redirect payment transactions to a desired
payment system. Parallels provides you with two sample proxy web applications which
you can use as a reference to develop your own one for integration with a desired
payment system. You will also need the integration documentation of the custom
payment system - to obtain information about required parameters and parameters'
names syntax. To obtain these samples, you need to install Plesk Sitebuilder SDK
(available for download here (http://swdn.swsoft.com/en/download/sitebuilder/)). After
you install Plesk Sitebuilder SDK, you will find the applications in the
<path_to_SDK_installation>\Samples\Integration\ASP\CustomPaymentSyste
m folder. This folder contains the applications allowing you to perform a test integration
with BluePay (BluePay.cs and Bluepay2API.cs) or Authorize.Net
(AuthorizeNet.cs) payment system, and a file with instructions on how to do this
(readme.htm).

 To integrate Plesk Sitebuilder with a custom payment system:

1 On the navigation pane, click Server.
2 On the Server screen, click Modules.
3 In the list of modules, click eShop.
4 On the eShop screen, go to the Custom Payment System tab.

66 Setting Up and Maintaining Plesk Sitebuilder

Figure 38: Integrating Custom Payment System: Specifying General Properties

5 On the Custom Payment System tab, select the Enable custom payment system

check box.

At any time later you can disable the custom payment system by clearing this check

box. In this case, all settings you specify during the payment system setup remain

on the screen in read-only format (grayed out), and the payment system becomes

unavailable to all site owners. After site owners republish their sites, the payment

system disappears from the Checkout form of their online stores.

6 In the Name field, specify a name for the payment system as it will be

displayed to end-users (e-shop owners and customers).
7 In the Payment gateway URL field, specify the URL pointing to your proxy

web application.
8 From the Request method list, select a method used for sending HTTP

request to the payment system (see the payment system

specification).
9 In the Positive result expression field, specify a regular expression to

define accepted transactions:

For example: errorText=(?'confirmationId'.+)

10 In the Negative result expression field, specify a regular expression to

define transactions declined by the payment system:

For example:errorText=(?'errorText'.+)

11 Specify parameters to be provided by online store owners - refer to

the payment system API documentation for information about required

parameters and parameters' names syntax.

Setting Up and Maintaining Plesk Sitebuilder 67

Figure 39: Integrating Custom Payment System: Specifying Parameters To Be

Requested from Online Store Owners

1. To add a new parameter, click Add New.

2. In the Parameter name field, enter the original parameter name.

3. In the Field name in the interface field, enter a name for the parameter as it will be
displayed to e-shop owners on the Payment Systems tab in the eShop module
editor.

4. In the Data type field, select a data type to be associated with the field. The
supported types are:

 String - allows specifying any arbitrary text string. It may include national

characters, punctuation marks, and spaces, but may not include line breaks.

 Text - same as string, but with line breaks allowed. On the published site the

text is displayed in the multi-line mode.

 E-mail - allows inputting e-mail addresses only.
 Double - allows entering a floating point number, with a point or a comma as

a decimal point.

 Integer - allows entering an integer number (positive, negative, or zero).
 Numeric - allows entering a positive integer number, or zero (only numbers

are allowed).

 Currency - allows entering a floating point number.
 Date - allows entering a date in format MM/DD/YYYY, with a slash ("/") as a

separator.

 Phone - allows entering an international phone number. May contain

numbers, spaces, parentheses, "+" and "-" symbols.

 Password - allows entering any arbitrary text string.
 CAPTCHA - allows entering a confirmation code from the provided picture, for

anti-spam protection purposes.

5. To specify whether the field is required for filling in or optional, select or clear
the Required check box.

68 Setting Up and Maintaining Plesk Sitebuilder

6. To set the order of the fields, click the corresponding upward and downward

arrows.

7. To delete a parameter, click the Delete icon beside the corresponding
parameter.

12 Specify parameters to be provided by online store customers - see

step 11.

13 In the Other parameters to be included in the HTTP request section, specify

which information should be taken from order information (i.e. from
the Plesk Sitebuilder database).

Figure 40: Integrating Custom Payment System: Specifying Parameters To Be Taken

from Placed Orders

1. To add a new parameter, click Add New.

2. In the Parameter name field, enter the original parameter name - refer to the
payment system documentation for information about required parameters and
parameters' names syntax.

3. From the Source list, select which part of order information will be used as the
source of the parameter's value.

The following options are available:
 Order ID. The identifier of an order in the orders index of a particular Plesk

Sitebuilder eShop module.

 Site ID. The identifier of an order originating site in Plesk Sitebuilder.
 Shop ID. The identifier of an order originating eShop module in Plesk

Sitebuilder (one site may contain several eShop modules).

 Site owner ID. The identifier of the site owner whose site originated an order.
 Site owner user name. The user name of a site owner.
 Order amount. The amount of an order (excluding the shipping cost).
 Order total. The amount of an order (with the shipping cost included).
 Order shipping cost. The shipping cost of an order.
 Currency ISO code. The ISO code of an order currency.

14 Click OK.

Setting Up and Maintaining Plesk Sitebuilder 69

 To test payment system operation, make a test purchase:

1 Register a developer account with the payment system.

A developer account will allow you to make payment transactions using test buyer
information, such as credit card number, CVV code, etc.

For instructions on registering a developer account, contact a payment system
representative by details provided on their web site.

2 Go to the Plesk Sitebuilder Wizard and create a site containing the

eShop module.

3 Go to Edit step > eShop page > Products tab and create a product.
4 Go to the Payment Systems tab.
5 Enable the payment system you want to test and specify your account

credentials.

6 Click Preview in the right-bottom part of the Plesk Sitebuilder window.
7 Navigate to the e-shop page and "buy" the product you have

previously created.

In case of a successful transaction, the order status must change from New to Paid on
the Orders tab of the online store, and the transaction ID of the order in the payment
system is placed in the order comment.

In case of a declined transaction, the order status must change from New to Failed. An
error message specifying the reasons of the failure (failed authorization, invalid credit
card number, etc.) is placed in the order comment in Plesk Sitebuilder, and displayed
on the site.

Updating Plesk Sitebuilder

Plesk Sitebuilder allows you to install product updates issued by Parallels directly from
your Administrator Panel.

 To update your Plesk Sitebuilder:

1 On the navigation pane, click Server.
2 Click Autoupdate.

3 Click Refresh to retrieve the most recent updates from the Parallels

server.

4 Select the update you want to install and click Download & Install.

70 Setting Up and Maintaining Plesk Sitebuilder

Specifying Hosts Used for Publishing
Sites

In Plesk Sitebuilder, sites can be published to:
 FTP servers. This option corresponds to the FTP publishing mode in site publishing

settings.

 To Parallels Virtuozzo Containers on servers running Parallels Business

Automation, Standard. This option corresponds to the Virtuozzo publishing mode in
user site publishing settings.

 Local Plesk Sitebuilder server using XCOPY technology. This option corresponds

to the XCOPY publishing mode in site publishing settings.

The basic Plesk Sitebuilder license allows you to register only one host. To purchase a
license with unlimited number of publishing servers, contact Parallels Sales
(mailto:[e-mail]).

The number of hosts defines the way you (and your dependent users) configure site
publishing settings:

 If the maximum number of hosts is Unlimited, then to publish to a host, it is not

necessary to register it in Plesk Sitebuilder - after a host is specified it in the site
publishing settings (see page 109), it is registered automatically.

 If the maximum number of hosts is limited, then to be able to publish a site to a host

it is necessary to register this host in Plesk Sitebuilder (see page 75) first. Once a host
is registered, it becomes available for selection in the site publishing settings.

For those users who do not have access to a server they could use for publishing sites,
you provide the publishing settings for the servers you have at your own disposal.
Which servers will be available to a particular user is defined in the service plan
assigned to that user.

To proceed to managing hosts, from the navigation pane, go to Server > Hosts.

Setting Up and Maintaining Plesk Sitebuilder 71

Figure 41: Publishing Servers Management Screen

In this section:

Requirements to Hosts ...................................................................................... 72

Adding Host....................................................................................................... 75

Specifying Hosts Available to Certain Users ...................................................... 77

Modifying Host Settings ..................................................................................... 77

Removing Host from List of Available Hosts ...................................................... 77

For information on how to operate with list objects, see Working with Lists (on page 23).
To be able to publish sites to a host, make sure that this host meets all Plesk

Sitebuilder requirements (see Requirements to Hosts (on page 72), and Verifying

Publishing Location (on page 74)).

72 Setting Up and Maintaining Plesk Sitebuilder

Requirements to Hosts

For the published sites to work correctly, publishing server must meet the following
requirements:

 ASP.NET 2.0.50727 or later is installed on the publishing server.

For detailed information about configuring ASP.NET 2.0, refer to the ASP.NET 2.0
Deployment Guide
(http://www.microsoft.com/downloads/details.aspx?familyid=9E33EA25-666C-

47FA-AC52-8D04785C4BD2&displaylang=en).

 The working directory is mapped on the IIS server as web application.
 Application pool to which the working directory is assigned does not contain

ASP.NET 1.1 applications.

 For the ASP.NET ISAPI to be executed, the working directory must have the

Scripting permission enabled (working directory menu > Execute Permissions >
Scripts Only).

 ASP.NET account has the following permissions:

 If the App_Data folder does not exist, read/write/delete permission for the

working directory is required.

 If the App_Data folder exists, then read/write/delete permission for the

App_Data folder and read permission for the working directory are required.

Note: 1. If you use IIS 5.0, the above permissions should be given to the

identity specified in

/configuration/system.web/deployment/processModel/@userN

ame of the

%WINDIR%\Microsoft.NET\Framework\v2.0.50727\CONFIG\machi

ne.config file.

2. If you use IIS 6.0, the above permissions should be given to the application
pool identity specified in IIS settings (Start > IIS Manager > Application Pools >
respective application pool > Properties > Identity tab).

 IIS application pool identity (NETWORK SERVICE by default) must have

permission to create files and folders in the %WINDIR%\temp folder.

 The order in which the default documents (default.htm, default.aspx, and so on) will

be used to respond the browser request is defined (working directory menu >
Properties > Documents tab).

 Publishing server works in the Medium Trust mode at least. If a server works in the

Medium Trust mode, it must be granted with OleDbPermission for accessing
Microsoft Access database and with WebPermission for some of the modules to
work correctly.

 OleDbPermission is set in the web_mediumtrust.config file, stored on

the publishing server. By default, this permission is disabled. To grant this
permission, you should add the OleDbPermission class to the following
sections of the web_mediumtrust.config file:

 SecurityClasses

Example:

Setting Up and Maintaining Plesk Sitebuilder 73

<SecurityClass Name="OleDbPermission"

In this section:

Verifying Publishing Location ............................................................................ 74

Description="System.Data.OleDb.OleDbPermission,
System.Data, Version=2.0.0.0,

Culture=neutral,

PublicKeyToken=b77a5c561934e089"/>

 PermissionSet

Example:
<IPermission class="OleDbPermission" version="1"

Unrestricted="true" />

 WebPermission is set in the web_mediumtrust.config file. To grant this

permission, add the WebPermission class to the PermissionSet section of
the web_mediumtrust.config file.

Example:
<IPermission class="WebPermission" version="1"

Unrestricted="true" />

Note: The server where Plesk Sitebuilder is installed must work in the Full Trust
mode.

More detailed information about OleDbPermission you can find here
(http://msdn2.microsoft.com/en-

us/library/ms998341.aspx#paght000020_oledbpermission).

More detailed information about trust levels you can find here
(http://msdn2.microsoft.com/en-us/library/wyts434y.aspx).

74 Setting Up and Maintaining Plesk Sitebuilder

Verifying Publishing Location

 To verify that a publishing location meets all the Plesk Sitebuilder requirements:

1 Go to Sites > site name > Publishing Settings tab.
2 Specify all the required parameters and click Verify Location.

The system will check whether the specified publishing parameters are valid and the
publishing location meets all the requirements. After completing the verification, the
publishing location is given one of the following statuses:

 Error. This status is assigned if the specified site URL is invalid.
 Static only. This status is assigned if the server you are trying to publish your site to

supports only static pages publishing.
If the site contains modules, publication fails. In this case, you can complete static

publication, if you delete all the dynamic pages from your site. The reasons why a
publishing server may not support dynamic content publishing are the following:

 ASP.NET 2.0 software is not installed on the server or is configured

incorrectly

 ASP.NET version is earlier than 2.0.50727
 The working directory is not mapped on the IIS server as web application
 ASP.NET account has not a read\write\delete permission for the App_Data

folder

 ASP.NET account has not read\write permission for the sitebuilder.mdb

file

 OLE DB Provider is not installed on the server

 Dynamic. This status is assigned if the publishing location meets all the

requirements and is ready for publishing.

Setting Up and Maintaining Plesk Sitebuilder 75

Adding Host

Prior to adding a host, read the requirements (on page 72) a publishing location must meet
in order for the published sites to work correctly.

 To add a host:

1 On the navigation pane, click Server.
2 Click Hosts.
3 Click Add New Host.
4 On the Host Settings tab, enter a host title in the Host title field.

It can be any title that will be easy for you to remember and associate with a
particular host.

Figure 42: Adding a Publishing Server: Specifying General Settings

5 In the IP address or DNS name field, enter the IP address or domain name

of the host.

Note: 1. Do not use loopback address (127.0.0.1) or domain name "localhost".

2. You cannot create two hosts with the same IP address.

6 To set up SMTP server for sending e-mail notifications from sites:

 Click the SMTP Settings tab.

76 Setting Up and Maintaining Plesk Sitebuilder

Figure 43: Adding a Publishing Server: Specifying SMTP Settings

 In the SMTP server host field, enter the domain name of the SMTP server.
 In the SMTP server port field, enter the number of port used for connection to the

SMTP server.

 In the SMTP server from address field, enter an e-mail address that will appear in

the 'From' field of notifications.

 If the SMTP server is password protected, click Change Password and provide the

credentials.

7 Click OK.

Setting Up and Maintaining Plesk Sitebuilder 77

Specifying Hosts Available to Certain Users

 To specify hosts available to certain users:

1 Create a special service plan for these users as described in Adding

Plan (on page 95) - or edit an existing plan (which may be already
assigned to some users) as described in Modifying Plan (on page 99).

2 On the Hosts tab, select the hosts you want to make unavailable and

click Remove from plan. On the same tab, select the hosts you wish to
include in the plan, and click Add to plan.

By default, all existing Plesk Sitebuilder hosts are included in all new plans.

3 Click OK.
4 Assign all respective users to this plan as described in Assigning Plan to

User (on page 99).

Modifying Host Settings

 To modify host settings:

1 On the navigation pane, click Server.
2 Click Hosts.
3 Click the name of the host you want to modify.
4 Make necessary changes and click OK.

Removing Host from List of Available Hosts

After deleting a host, it is removed from all plans, containing it, and from all publishing
parameters of the sites scheduled for publishing on this host. Sites already hosted on
the removed host are not affected, but they cannot be re-published to this host any
longer.

 To remove a host:

1 On the navigation pane, click Server.
2 Click Hosts.
3 Select the host you want to remove.
4 Click Delete.

78 Setting Up and Maintaining Plesk Sitebuilder

Setting Up Plesk Sitebuilder for

In this section:

Setting Up Service Plan for Anonymous Users .................................................. 79

Setting Language and Skin for Anonymous User Sessions ............................... 80

Setting Up Advertising Banner Shown on Trial Sites ......................................... 81

Setting Up Message Displayed at Publish Step of Wizard ................................. 82

Setting Up Notification Sent at Trial Site Publication Attempt ............................ 83

Inserting Macros, Links, and HTML Code into Notification Messages ............... 85

Prohibiting Anonymous Users from Accessing Plesk Sitebuilder Wizard ........... 87

Anonymous Visits

You can offer your potential customers a free trial of Plesk Sitebuilder Wizard, so they
could create a site without any purchasing obligation. The demo version of Plesk
Sitebuilder can be accessed by the URL http://[Sitebuilder_host:port]/wizard.

Users accessing Plesk Sitebuilder in demo mode are called anonymous users, and
sites they create are called trial sites. Trial sites have a limited lifetime period and
cannot be published until their owners register in Plesk Sitebuilder (and purchase
hosting services).

You can at your discretion set up the Wizard for anonymous visits: set a service plan,
interface skin, and default interface language common for all anonymous users,
configure advertising banner to be placed on every trial site and set up notification
messages sent/displayed to anonymous users. Or you can prohibit anonymous users
from accessing the Plesk Sitebuilder Wizard.

Setting Up and Maintaining Plesk Sitebuilder 79

Setting Up Service Plan for Anonymous Users

A plan is a set of limits and permissions applied to each Plesk Sitebuilder user. Unlike
with registered users - when you can assign particular user accounts to particular plans

- anonymous users are subject to a single special plan (trial plan), which you can set
up according to your needs.

During Plesk Sitebuilder installation, a default trial plan is created. You cannot delete or
deactivate this default plan until another plan is created and set as a trial plan instead
of it.

 To set up service plan for anonymous Wizard users:

1 On the navigation pane, click Users.
2 Click Plans.
3 To modify the default plan, click it and make necessary changes.
4 To set up a new plan:

 Click Add New Plan, set up the new plan according to your needs and click OK.

(For more details on creating plans, refer to Adding Plan (on page 95))

 Select the check box beside the newly created plan and click Set as Trial Plan.
The plan which is set for anonymous visits is indicated with color.

80 Setting Up and Maintaining Plesk Sitebuilder

Setting Language and Skin for Anonymous User
Sessions

 To set Wizard interface language and skin for anonymous visits:

1 On the navigation pane, click Server.
2 Click Trial Sites Settings.
3 Go to the Wizard Interface tab.

Figure 44: Setting Up Language and Skin for Anonymous User Sessions

4 From the Language list, select the desired language.
5 From the Skin list, select the desired skin.
6 Click OK.

Setting Up and Maintaining Plesk Sitebuilder 81

Setting Up Advertising Banner Shown on Trial Sites

In Plesk Sitebuilder, you to place an advertising banner on every site created by
anonymous Wizard users. This advertising banner is a text message displayed in the
top left corner of the trial site screen. You can configure this message to promote your
web hosting services, and make it a hyperlink to your corporate web site.

 To configure advertising banner message:

1 On the navigation pane, click Server.
2 Click Trial Sites Settings.
3 Click the Advertising Banner tab.
4 If you wish to set your advertising banner in different language, select

the desired language from the Language list.

5 In the Advertising banner message text box, specify the desired text.

Figure 45: Configuring Advertising Banner Shown on Trial Sites

6 Click OK.

Above the Advertising banner message text box, there is the Promotional link which opens
the Plesk Sitebuilder Wizard in guest mode. You can use this link to attract potential
customers by giving them a chance to try out the software and create trial sites before
they decide to get a Plesk Sitebuilder account and purchase hosting services. The
process of providing the instructions on how an anonymous user can register and
upgrade a trial site to a regular site is described in Setting Up Message Displayed at Publish
Step of Wizard (on page 82).

For each of your resellers, a separate promotional link is generated - to identify the
owner of certain trial sites and assign the sites to the corresponding user.

82 Setting Up and Maintaining Plesk Sitebuilder

Besides text, you can insert the following elements in the body of advertising banner
message:

 Macros (see page 85)
 HTML code (see page 85)
 Hyperlinks (see page 86)
 E-mail links (see page 86)
 Anchors (see page 87)

Setting Up Message Displayed at Publish Step of
Wizard

When anonymous Wizard users try to publish a site, they see a message saying that
publishing is not available until they sign up. This message also contains general
information about their site, including its URL, site lifetime period, and instructions on
how to publish the site permanently. You can customize this message and insert any
relevant information into it.

 To set up message displayed at the Publish step of the Wizard:

1 On the navigation pane, click Server.
2 Click Trial Sites Settings.
3 Click the Publish Step Message tab.

Figure 46: Setting Up Message Displayed at Publish Step of Wizard

Setting Up and Maintaining Plesk Sitebuilder 83

4 If you wish to set your notification message in a different language,

select the desired language from the Language list.

5 Specify the information you want to deliver to the anonymous users.
6 Click OK.

Besides text, you can insert the following elements in the body of the message:

 Macros (see page 85)
 HTML code (see page 85)
 Hyperlinks (see page 86)
 E-mail links (see page 86)
 Anchors (see page 87)

Setting Up Notification Sent at Trial Site Publication
Attempt

After creating a trial site, on the Publish screen of Plesk Sitebuilder Wizard, an
anonymous user is offered to send information about the trial site to his or her e-mail.
You can configure the autoreply message sent by Plesk Sitebuilder in response to such
requests. Plesk Sitebuilder offers a default text of the message, which you can replace
with your own text or edit as desired.

The SMTP server through which the notification messages are sent you set up at

Server > SMTP Server Settings (for more details, refer to Setting Up SMTP Server for Sending
Notifications from Plesk Sitebuilder (on page 41)).

 To configure notification sent to anonymous users at trial site publishing attempt:

1 On the navigation pane, click Server.
2 Click Notifications.

84 Setting Up and Maintaining Plesk Sitebuilder

Figure 47: Setting Up E-mail Message Sent at Trial Site Publication Attempt

3 If you wish to set your notification message in a different language,

select the desired language from the Language list.

4 In the From field, specify the sender's e-mail address.
5 In the Subject field, type the subject of notification message.
6 In the Text field, type the text of notification message.

Besides text, you can insert the following elements in the body of the notification
message:

 Macros (see page 85)
 HTML code (see page 85)
 Hyperlinks (see page 86)
 E-mail links (see page 86)
 Anchors (see page 87)

Setting Up and Maintaining Plesk Sitebuilder 85

Inserting Macros, Links, and HTML Code into
Notification Messages

View the following topics for guidelines on how to insert macros, links, and HTML code
into notification messages sent to anonymous Plesk Sitebuilder users.

Inserting Macros

When composing notification messages, you can use macros - placeholders for various
information which will be automatically replaced with the real information when
message is displayed to a reader. For example, the sb:sitepreviewlink macro will be
replaced with the link to a site in the preview mode, and the sb:siteeditlink macro will
be replaced with the link to a site in the editing mode.

 To insert a macro into notification message:

1 Place the cursor where you want to insert a macro.
2 Select the desired macro from the Macro list.
3 Click OK.

Inserting HTML Code

If you want to arrange the text of notification message beyond standard formatting, you
can use HTML tools for that purpose.

 To format notification message in HTML mode:

1 Click the HTML mode icon.
2 Make necessary formatting changes.

To preview the formatted text, click the Simple text mode icon.

3 Click OK.

86 Setting Up and Maintaining Plesk Sitebuilder

Inserting Hyperlinks

 To insert a hyperlink:

1 Place the cursor where you want to insert a link (or select a text which

you want to set as hyperlink).

2 Click the Hyperlink Manager icon.
3 In the URL field, specify the web address which you want the link to

point to.

4 In the Link text field, specify (or change) the text that will make up the

link.

5 From the Protocol list, select the protocol to be used to access the

linked resource (http, ftp, and other).

6 From the Target list, select how the link will open (in the same window,

in the new window, and so on).

7 In the Tooltip field, type the text to be displayed when the cursor is

hovered over the link.

8 To set up the appearance of the link, select a desired style from the

CSS class field.

9 Click OK.

Inserting E-mail Links

You can insert a link to an e-mail address into your notification message.

 To insert an e-mail link:

1 Select the text which you want to set as the e-mail link.
2 Click the Hyperlink Manager icon.
3 Click the E-mail tab.
4 In the Address field, type the needed e-mail address.
5 In the Subject field, type the text that will be the subject of the e-mail

message.

6 To set up the appearance of the link, select a desired CSS class from

the CSS class list.

7 Click OK.

Setting Up and Maintaining Plesk Sitebuilder 87

Inserting Anchors

Anchor is a word or a group of words that define the destination a hyperlink leads to.
Anchors are very helpful in facilitating navigation through a great amount of text located
in a single place. With this function, you can provide the readers of the message with
an easy way to jump from one part of the text to another.

 To insert an anchor:

1 Place the cursor where you want the link to lead to.
2 Click the Hyperlink Manager icon.
3 Click the Anchor tab.
4 Enter a name for the anchor and click OK.
5 Select some text or an image that will be the hyperlink leading to the

anchor.

6 Click the Hyperlink Manager icon again.
7 On the Hyperlink tab, select the newly created anchor from the Existing

anchor field.

8 Click OK.

Prohibiting Anonymous Users from Accessing Plesk
Sitebuilder Wizard

 To prohibit anonymous users from accessing the Plesk Sitebuilder Wizard:

1 Open the <path_to_Sitebuilder>/Web/web.config file
2 Find the 'AllowAnonymousSites' parameter and change its value

to 'false'.

88 Setting Up and Maintaining Plesk Sitebuilder

Viewing Plesk Sitebuilder Logs

Logs are journals of actions and errors occurring in your Plesk Sitebuilder. Logs help
you to determine the source of system errors and restore the chain of events that led to
a particular error. Also, logs make it easy to determine which user is responsible for a
particular error.

 To view logs:
1 On the navigation pane, click Logs.

Figure 48: Logs Management Screen

Log records of the same type are arranged into groups. On the Logs screen, you
can see the following general information about log groups:

 L. The level of severity of logged events. Below is a list of possible severity

levels:
 Debug. Logs of this type contain information about Plesk Sitebuilder internal

services' activities.

 Info. Logs of this type contain the results of operations on Plesk Sitebuilder

objects (sites, user accounts, etc.).

 Warning. Logs of this type contain warnings about unsuccessful completion of

operations due to overreaching some limits. For example, if a site was not
created because the limit on sites was overreached.

 Error. Logs of this type contain information about any error occurred in Plesk

Sitebuilder. For example, if there is not enough disk space on the Plesk
Sitebuilder server.

 Fatal. Logs of this type contain information about critical errors.

Setting Up and Maintaining Plesk Sitebuilder 89

To define starting from which level of severity the events will be logged, open the
<path_to_Sitebuilder>\Web\log4net.config file and edit the value of the level
parameter. For example, to log only critical errors, set the value of the level
parameter to 'FATAL':

<level value="FATAL"/>

If you specify a less-severe level, then Plesk Sitebuilder will log the events of all
more-severe levels left. For example, if you set the severity level to 'DEBUG', Plesk
Sitebuilder will log events with Info, Warning, Error, and Fatal levels; if you set the
severity level to 'INFO', Plesk Sitebuilder will log events with Warning, Error, and
Fatal levels; etc.

 Last log date. The date when the last log in a group was recorded.
 Logs. The number of logs contained in a group.

2 To view the detailed information about a particular group, click it in

the list.

Figure 49: Viewing Log Group Details

3 In the Log group details area, you can view the following additional

information about the group:

 Group creation date. The date when the group was created.
 Message. The generic description of the logged event.
 Stack trace. A record showing the origin of the logged action, that is where

exactly in the system the logged action occurred.

 Logger. The name of the internal Plesk Sitebuilder service that generated the log

record.

 Group hash. A digital identifier of the group in the system.
 Plesk Sitebuilder version. The version number of your Plesk Sitebuilder.

4 To view a list of logs contained in the group, click View all logs.

90 Setting Up and Maintaining Plesk Sitebuilder

Figure 50: Vewing Logs Contained in a Particular Group

5 To view a particular log, click it in the list.

Figure 51: Viewing a Particular Log Record

6 For each log, the following detailed information is available:

 Position in list. The index number of the log in the list sorted by certain parameter

and in certain order.

 Message. The description of the logged event.
 Creation date. The time and date when the log was generated
 User name / User ID. The user name or ID of the user who was logged in when the

log was generated

 Site ID. The ID of a Plesk Sitebuilder site originated the log.

Setting Up and Maintaining Plesk Sitebuilder 91

 User agent. Selected information about the software installed on the user's

computer (for example, user's operating system and browser).

 Requested URL. The URL of the page where the logged event occurred.
 IP address. The IP address of the user who was logged in when the log was

generated.

 Referrer URL. The URL of the page previous to the page where the logged event

occurred.

 Impersonating user. The user name of a user who was logged in under another

user's account when the log was generated.

To write the buffered logs into the Plesk Sitebuilder database and refresh the list of log
groups, click Refresh.

To delete the logs older than a certain date, select a desired date and click Clear all
logs.

This chapter tells how to sign up and manage customers, set up service plans for them,

In this chapter:

Setting Up Service Plans ................................................................................... 93

Signing Up Customers ...................................................................................... 101

Managing Sites ................................................................................................. 107

C H A P T E R 5

Serving Your Customers

and manage web sites.

Serving Your Customers 93

Setting Up Service Plans

In Plesk Sitebuilder, a plan is a set of limits applied to user accounts assigned to it. The
general purpose of plans is to regulate distribution of the Plesk Sitebuilder resources, such
as hosts, sites, modules, and so on among the users.

In Plesk Sitebuilder, one of the plans must be set as a plan for anonymous users - for they
could access the Wizard and create trial sites. So, when you log in to Plesk Sitebuilder for
the first time, there is already one trial service plan in the list. You cannot delete or deactivate
a trial plan, but you still can prohibit anonymous users from accessing the Wizard (see page 87).

Trial service plan can be assigned to regular users as well - all the advanced permissions
contained in this plan (the publishing settings access, hosts and promotional footers) are
disabled for anonymous users.

Service plans can be created and managed only by the users with administrator or reseller
accounts. Such users create custom plans and then assign them to dependent users.
Dependent users, in their turn, can create their own plans within the limits set in the plan
assigned to them by a higher user. For information about creating user accounts and
assigning plans to them, read Signing Up Customers (on page 101).

For you, as administrator, the Plesk Sitebuilder license plays the role of plan. For detailed
information about the license, read Upgrading Your License (on page 36).

To proceed to managing plans, from the navigation pane, go to Users > Plans.

Figure 52: Plans Management Screen

94 Serving Your Customers

For information how to operate with list objects, see Working with Lists (on page 23).

In this section:

Adding Plan ....................................................................................................... 95

Assigning Plan to User ...................................................................................... 99

Modifying Plan ................................................................................................... 99

Changing Plan Status ........................................................................................ 100

Removing Plan .................................................................................................. 100

Serving Your Customers 95

Adding Plan

 To add a plan:

1 On the navigation pane, click Users.
2 Click Plans.
3 Click Add New Plan.
4 Click the General tab.

Figure 53: Creating a Service Plan: Specifying General Settings

5 In the Name field, specify a name for the new plan.
6 To easily distinguish the created plan from other plans, you can provide a

short description for it in the Description field.

7 Define the maximum number of:

 Pages per site
 Root level pages per site

96 Serving Your Customers

 Regular sites
 User accounts
 Hosts

- that the plan assignees are allowed to have.

8 If you are creating the plan to be used for anonymous visits to the Wizard,

define the period of time during which sites created by anonymous Wizard
users will be stored on your server.

9 To make up the list of hosts, templates, page sets, modules, and site

families to be included in the plan, click the respective tab, select one or
several objects and click Add to Plan or Remove from Plan.

Figure 54: Creating a Service Plan: Specifying Publishing Servers To Be Available to Plan

Assignees

Whether an object is or is not included in the plan is indicated with the signs (included)
and (not included).

You can add modules to the plan for evaluation purposes only, which gives site owners a
chance to try out required modules before they pay for them. To do so, select one or

several modules and click Add to Plan for Evaluation. Users under this plan will not be
able to publish sites containing evaluation modules until they purchase an appropriate
service plan from you. Resellers under this plan will not be able to remove the 'evaluation
only' status from a module.

Note: Site families may have two statuses: activated or deactivated status (indicated in
the A column). A site family has activated status if the page set and at least one template
from the category specified for the site family are included in the plan. If this condition is
not met, you can add the site family to the plan, but it will be marked as deactivated,
which means that the sites containing this site family are not available for visitors.

10 Go the Publishing Settings tab.

Serving Your Customers 97

Figure 55: Creating a Service Plan: Configuring Site Publishing Settings

 If you wish to allow users to change the publishing settings of their sites, select the

Allow users to modify publishing settings check box.
Users without this permission can publish their sites only after a higher-level user

specifies the publishing settings for their sites.

Note: For site owner accounts, you need to allow this permission in the Plesk

Sitebuilder configuration file as well. To do so, open the
<path_to_Sitebuilder>/Web/web.config file, find the
'PublishSettingsVisibleForSiteOwner' parameter and change its value to
'true'.

 Specify the publishing modes available for users assigned to this plan. The options

are: FTP, Virtuozzo, and XCOPY.

Note: Which publishing modes are available to you is defined in your license

(navigation pane > Server > License Management > License Info tab).

11 If you wish to include your own promotional content into your users' site

pages, go to the Promotional Footers tab and enter the content into the text
box.

98 Serving Your Customers

Figure 56: Setting Up a Promotional Footer To Be Placed on the Plan Assignees' Sites

The content may include all kinds of animation, banners, pop-up windows, and text
messages. This content is displayed on all site pages, including the second-level pages
of Plesk Sitebuilder modules, below the page content area. The promotional content you
include here is displayed to all users assigned to this service plan, and to their dependent
users.

12 If you wish to let resellers add their own content to your promotional

footers, select the Allow resellers to append to your promotional footers check box.

Resellers assigned to the current plan cannot edit the content you have added. They can
append their own content, and can in turn enable or disable this option for their
dependent resellers.

13 Click OK.

Note: Every created plan must include at least one design template and site family.

Serving Your Customers 99

Assigning Plan to User

 To assign a plan to a user:

1 On the navigation pane, click Users.
2 Proceed to creating a new user account or select an existing one.
3 From the Plan list, select a plan.

Figure 57: Assigning a Service Plan to a User Account

4 Click OK.

Modifying Plan

 To modify a plan:

1 On the navigation pane, click Users.
2 Click Plans.
3 Click the plan you want to modify.
4 Make necessary changes.
5 Click OK.

After you update the plan parameters, new values are applied to all the users to whom this
plan is assigned.

100 Serving Your Customers

Changing Plan Status

In Plesk Sitebuilder, a plan can have either activated or deactivated status. Deactivation of a
plan is used to mark those plans which you have assigned to certain users but do not want to
assign to any other users. Deactivation of a plan has no impact on the workflow of the users
this plan is assigned to. You can always change the deactivated status back to activated.

 To change plan status:

1 On the navigation pane, click Users.
2 Click Plans.
3 To deactivate a plan, select an active plan and click Deactivate.
4 To activate a deactivated plan, select it and click Activate.

Note: You cannot deactivate a trial plan.

Removing Plan

Note that you cannot delete a plan if it is assigned to some users.

 To remove a plan:

1 On the navigation pane, click Users.
2 Click Plans.
3 Select the plan you want to remove.
4 Click Delete.