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-UsersSite 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
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
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
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:sales@parallels.com).
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
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
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 (freeof-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:
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\CustomPaymentSystem 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:sales@parallels.com).
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
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
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:
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
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.
Loading...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.