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 Parallels 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
a reseller 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]/Login
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.
Parallels Plesk Sitebuilder consists of two parts: the Wizard and the Administrator
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
Panel.
Plesk Sitebuilder 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 Plesk Sitebuilder user roles. Each user role
has its own Administrator Panel, in which users can manage Plesk Sitebuilder objects
they own within the privileges provided by their service plans.
There are three user roles in Plesk Sitebuilder:
1 Administrator manages all Plesk Sitebuilder elements.
2 Reseller is a distributor of the Plesk Sitebuilder services.
Resellers may 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 reseller and site owner accounts.
Add and manage sites.
Configure system settings, such as the settings of Plesk Sitebuilder presets and
modules.
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 credentials (login and password) upon this
purchase. Their main tool is Plesk Sitebuilder Wizard, which is described in Parallels Plesk Sitebuilder for Linux/Unix Wizard User's Guide
(http://www.parallels.com/en/products/sitebuilder/docs/). Site owners can manage
their own sites only.
Besides, you, as a reseller, can make 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 users can use Plesk Sitebuilder Wizard only.
About Plesk Sitebuilder 9
Overview of Plesk Sitebuilder Business
Logic
Read this section to understand the logic of Plesk Sitebuilder application, learn
information about its major features and functionalities, and work out the most
reasonable and time-saving order of operations to be performed.
The 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:
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.
Viewing or configuring Plesk Sitebuilder Wizard presets and functional modules:
Site structure templates, or page sets (creating your custom page sets).
General site templates, or site families (creating your custom site families).
Functional modules (Area Map, SitePal, and eShop).
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:
Obtaining your promotional link to Plesk Sitebuilder Wizard demo for distributing
among your potential customers.
Creating a special trial service plan for anonymous users.
Setting up the message displayed on the Publish step of the Wizard, the
advertising banner to be shown on trial sites, and configuring the automatic email notification sent to users after the creation of a trial site.
Serving your customers
At this stage, you integrate Plesk Sitebuilder into your business processes 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 (resellers and site owners) 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:
Submit users' sites to Google and MSN search engines.
Enable and view site attendance statistics.
The current Reseller'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:
Site Map module. Allows site owners to display a clickable hierarchical model of their
site structure to visitors
Removing design template from pages. Site owners can now remove design template's
layout and graphics from the desired pages.
External Page module. Allows site owners to link site menu items to external web
sites.
Save button. A handy way for site owners to save changes they make while working
on their site.
Counter settings are moved to the Wizard. Site owners can now enable a counter on
their sites at the Pages step of the Wizard, which previously required them to go to
the Administrator Panel.
Site visitor management is moved to the Wizard. Site owners can now manage their
registered visitors through the Registration module editor at the Edit step of the
Wizard, which previously required them to go to the Administrator Panel.
Updated WYSIWYG editor to fix a series of issues.
This chapter guides you through the initial steps that should be taken to start using
In this chapter:
Logging In to Plesk Sitebuilder .......................................................................... 12
Getting Help ...................................................................................................... 25
C H A P T E R 2
Getting Started with Plesk Sitebuilder
Plesk Sitebuilder.
12 Getting Started with Plesk Sitebuilder
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/login
where 'sitebuilder' is the domain name of the server where Plesk Sitebuilder is
installed.
2 Press ENTER.
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 language of Plesk Sitebuilder
interface.
6 Click Log in.
You receive your Plesk Sitebuilder URL and your default Administrator Panel access
credentials from your Plesk Sitebuilder administrator.
You can change your password at any time. For details, see section Changing Your Password and Updating Personal Information (on page 27).
1 In your browser's address bar, enter the URL to your Plesk Sitebuilder
Administrator Panel.
For example, http://sitebuilder/login
where 'sitebuilder' is the domain name of the server where Plesk Sitebuilder is
installed.
2 Press ENTER.
3 Click Forgot Your Password?
Figure 2: Recovering Forgotten Password
4 On the Reset Password screen, enter your user name and e-mail
address registered in the system.
5 Click Send.
After your e-mail address is received, the system checks if it is stored in the
database and sends the password recovery link and instructions to your e-mail
address.
6 Click the password recovery link in the automatic message you
receive from Plesk Sitebuilder.
7 On the Change Password screen, enter and confirm your new password.
8 Click Change.
Getting Started with Plesk Sitebuilder 15
Learning Plesk Sitebuilder Administrator
In this section:
Navigating in Plesk Sitebuilder .......................................................................... 16
Working with Lists ............................................................................................. 21
Using Context Help ........................................................................................... 23
Panel Interface
Read the following section to learn the basic principles of working with Plesk
Sitebuilder interface.
16 Getting Started with Plesk Sitebuilder
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 (see page 18) 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 3: Plesk Sitebuilder Standard View
The desktop view (see page 19) displays system statistics and shortcuts to the main
functionalities of the Administrator Panel.
Getting Started with Plesk Sitebuilder 17
Figure 4: Plesk Sitebuilder Desktop View
In this section:
Using Navigation Pane ...................................................................................... 18
Using Desktop Interface .................................................................................... 19
Using Path Bar .................................................................................................. 21
On second- and deeper-level screens, there is a path bar (see page 21) to help you
navigate back to the main screen.
18 Getting Started with Plesk Sitebuilder
Using Navigation Pane
The navigation pane is located in the left part of the Plesk Sitebuilder screen.
Figure 5: Plesk Sitebuilder 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 (including service plans).
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, such as
trial site settings, branding settings, Sitebuilder Wizard presets and modules, and
so on.
System Info. Enables you to view information about the Plesk Sitebuilder program
and the limits and permissions of your service plan.
Log out. Finishes your current session with Plesk Sitebuilder.
Support. Enables you to submit a request to your technical support
representative.
Help button opens the context-sensitive online help on the corresponding page.
Getting Started with Plesk Sitebuilder 19
Using Desktop Interface
Plesk Sitebuilder desktop is the first screen you see after you log in to Plesk Sitebuilder
using your administrator account. When working in Plesk Sitebuilder, you can access
the desktop by clicking Desktop on the top of the navigation pane.
Plesk Sitebuilder Desktop looks as follows:
The Desktop screen is logically divided into the following parts:
1 If you have not signed up your Plesk Sitebuilder 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 section Setting Up Area Map Module (on page 54).
2 Short tips describing basic management options of the Plesk Sitebuilder
Administrator Panel and shortcuts to these options.
20 Getting Started with Plesk Sitebuilder
3 Shortcut to 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. If
you have a number of regular sites, and wish to create a new one, refer to Creating Your Own Site in Plesk Sitebuilder Wizard (on page 105), further in this guide, for details.
Information about working with the Wizard is provided in the Plesk Sitebuilder for Linux/Unix Wizard User's Guide
(http://www.parallels.com/en/products/sitebuilder/docs/).
If you do not want these options to be displayed ever again, click Close in the
bottom right corner of the section. When you log in to Plesk Sitebuilder next time,
this section is not displayed.
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 service plan.
Regular sites. The number of sites in the system and the maximum number of
sites allowed by your service plan.
Hosts. The number of registered publishing servers and the maximum number of
publishing servers allowed by your service plan.
5 Tasks section, which contains shortcuts to the main functionalities of the
Administrator Panel.
Getting Started with Plesk Sitebuilder 21
Using Path Bar
To work with the second- and deeper-level screens of the application, use a path bar: a
chain of links that appears in the upper-left part of the work area, above the screen title.
Use a corresponding path bar link to return to the main screen, or to one of the
intermediate screens.
Figure 7: Navigating in Plesk Sitebuilder Using Path Bar and "Up Level" Button
You can also use the Up level button in the upper-right corner of the screen to return
to the previous screen.
Working with Lists
On the management pages of various system objects (sites, users, etc.), information is
present 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 (5, 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 Page or Last Page, 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 Shown per Page (on page
28).
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 8: Searching for 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.
22 Getting Started with Plesk Sitebuilder
Figure 9: 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, My and my users' sites, and My trial sites).
Figure 10: Filtering Objects
To choose an object for further operation, select the check box to the left of the object's
name.
Figure 11: Selecting Particular Objects in a List
To choose all objects in the list, select the check box at the head of the column.
Figure 12: Selecting All List Objects at Once
To perform operations with objects in a list, select the required objects and click the
group operation shortcut above the list (for example, Delete, Activate, Add to plan, etc.).
Getting Started with Plesk Sitebuilder 23
Figure 13: Performing Operations on List Objects
To proceed to editing a list item, click its name in the list. The non-editable items (for
example, most of the Plesk Sitebuilder modules) are not clickable.
In all major Plesk Sitebuilder lists, the status of an item is indicated by a status icon in
the Status (S) column ( or ). For sites, their status (published or unpublished), is
indicated by or icons.
In some lists, individual operation shortcuts are displayed for each item. For example,
for each site on the Sites screen, there is a Preview icon, a Publish icon, and an
Edit icon.
Using Context Help
Below the Help icon, there is a context help tip area. It provides a brief description of the
current screen and the operations available from it. When you place the mouse cursor
over a system element or status icon, additional information about this element is
displayed.
24 Getting Started with Plesk Sitebuilder
Figure 14: Using Context Help
Getting Started with Plesk Sitebuilder 25
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/sitebuilderlinux).
The knowledge base provides solutions to the most common problems with Plesk
Sitebuilder.
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 account, view information about the Plesk
In this chapter:
Changing Your Password and Updating Personal Information .......................... 27
Choosing Language, Skin and Number of Items to Be Shown per Page ........... 28
Setting Up Global Account ................................................................................ 29
Viewing Information about Your Copy of Plesk Sitebuilder and Service Plan
Sitebuilder software and limits and permissions set in your service plan.
Configuring Settings Related to Your Account 27
Changing Your Password and Updating
Personal Information
To change your password:
1 On the navigation pane, click My Profile.
Figure 15: Changing Your Password and Personal Information
2 On the Personal Info tab, click Change Password.
3 Type your old and new passwords in the respective fields.
The password cannot be empty and cannot contain more than 255 characters.
4 Click OK.
To update your personal information:
1 On the navigation pane, click My Profile.
2 On the Personal Info tab, you can update your first, last name and e-
mail address in the corresponding fields.
3 Click OK.
28 Configuring Settings Related to Your Account
Choosing Language, Skin and Number of
Items to Be Shown per Page
To customize your Administrator Panel interface:
1 On the navigation pane, click My Profile.
2 Go to the Interface tab.
Figure 16: Choosing Language, Skin, and Number of List Items Shown per Page
3 From the Language list, select the desired language.
The set of languages available to you is determined by your Plesk Sitebuilder
administrator. If you wish to obtain extra language packs, contact your Plesk
Sitebuilder administrator for assistance.
4 From the Skin list, select the desired skin.
5 In the Items per page field, specify the number of items to be displayed
per one page.
Configuring Settings Related to Your Account 29
Setting Up Global Account
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
by Plesk Sitebuilder administrator.
If the SSO feature is enabled in your Plesk Sitebuilder, you can proceed to managing
your SSO settings by clicking the Global Account shortcut in the navigation panel.
Figure 17: Proceeding to Managing Your Global Account
30 Configuring Settings Related to Your Account
In this section:
Creating Global Account ................................................................................... 30
Connecting Local Accounts to Your Global Account .......................................... 31
Switching between Accounts ............................................................................. 32
Editing Global Account Password ...................................................................... 33
Disconnecting Local Accounts from Global Account .......................................... 33
Creating Global Account
To create a global account:
1 On the navigation pane, click Global Account.
2 Click Connect to Global Account.
3 Select Create new global account.
Figure 18: Creating a 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. Refer to Connecting Local Accounts to Your Global Account (on page 31).
Configuring Settings Related to Your Account 31
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 19: Connecting an Existing Local Account 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.
32 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 to 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 32).
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 for another global account. You can
also choose the language for your control panel from the Interface language list.
Figure 20: Switching to Another Account, Local or Global
4 Click Log In.
Configuring Settings Related to Your Account 33
Editing Global Account Password
To edit the properties of 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 To change your password, enter your old and new passwords in
respective fields.
5 If necessary, edit your global account e-mail address.
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.
4 Click OK to confirm the disconnection.
Repeat the procedure for other local accounts as necessary.
34 Configuring Settings Related to Your Account
Viewing Information about Your Copy of
Plesk Sitebuilder and Service Plan
Limitations
To view information about the Plesk Sitebuilder program, and the limits and
permissions set in your plan:
1 On the navigation pane, click System Info.
Figure 21: Viewing Information about Your Copy of Plesk Sitebuilder
2 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 .................................................................... 35
Viewing and Configuring Plesk Sitebuilder Wizard Presets and Modules .......... 38
Specifying Hosts Used for Publishing Sites ....................................................... 66
Setting Up Plesk Sitebuilder Wizard for Anonymous Visits ................................ 71
In this section:
Setting Up Logo and Title Bar Text ....................................................................36
Customizing Help and Support Button Links ......................................................36
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 Plesk Sitebuilder
Wizard, to regular and anonymous users, and in all dependent users' Administrator
Panels.
You can customize links attached to the Help and Support buttons in the
Administrator Panel and in the Wizard.
36 Setting Up and Maintaining Plesk Sitebuilder
Setting Up Logo and Title Bar Text
To set up your logo:
1 On the navigation pane, click Server.
2 Click Branding.
Figure 22: Customizing Application Logo and Title Bar Text
3 On the Logo & Title tab, 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 be 150x40 px in size and must be in one of the
following formats: *.jpeg, *.jpg, *.gif, or *.png.
5 To make the logo a link to your 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 On the same Logo & Title tab, 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.
Customizing Help and Support Button Links
To customize help and support links:
1 On the navigation pane, click Server.
Setting Up and Maintaining Plesk Sitebuilder 37
2 Click Branding.
3 Go to the Help & Support Links tab.
Figure 23: Customizing Help and Support Links
4 In the Help area, specify your custom links to the online guides for
different user roles.
5 In the Support link field, enter your custom link:
To make the link point to an e-mail address, specify the e-mail link in format
mailto:your@e-mail.com.
To make the link point to a support page on your web site, specify the page URL
(with the http:// prefix).
6 Click OK.
38 Setting Up and Maintaining Plesk Sitebuilder
Viewing and Configuring Plesk Sitebuilder
In this section:
Specifying Site Design Templates Available to Certain Users ............................39
Managing Site Structure Templates (Page Sets) ...............................................39
Managing Site Templates (Site Families) ................................ ...........................46
Plesk Sitebuilder is shipped with a number of built-in site development presets
(templates intended to facilitate the site creation process in Plesk Sitebuilder Wizard)
and modules (components which extend the site functionality: Blog, Guestbook, eShop,
etc.).
The set of site development templates and modules you have at your disposal is
regulated by your service plan. Which templates and modules will be available to your
dependent users you define in their service plans. Creating or integrating custom
modules is not supported.
There are three types of site development templates:
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
Wizard, and then tweak it according to their preferences by choosing a color
scheme, page banner, and menu style.
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 Wizard. If it is allowed by the Plesk Sitebuilder
license, you can create your own pages sets 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 the Plesk
Sitebuilder license, you can create your own site families and provide them to your
users. These site templates are offered to your users on the Start page of the
Wizard. The choice of a site family determines:
The choice of a default design template on the Design step of the Wizard
The choice of a default page set offered on the Pages step of the Wizard.
On each respective step, your users can choose any other design template or page
set instead of the ones provided by a chosen site family.
Setting Up and Maintaining Plesk Sitebuilder 39
Specifying Site Design Templates Available to Certain
Users
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.
The list of site design templates available to you is defined by Plesk Sitebuilder
administrator in your service plan. If you wish to obtain more design templates, contact
your Plesk Sitebuilder administrator for assistance.
To specify available design templates for certain dependent users:
1 Create a special service plan for these users as described in Adding
Plan (on page 87) - or edit an existing plan (which may be already assigned to some users) as described in Modifying Plan (on page 92).
2 In this plan, on the Templates tab, select the design templates you want
to hide from the plan users, 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 90).
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 73).
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 Wizard. If it is allowed by the Plesk Sitebuilder license, you can
create your own page sets either on the basis of existing Plesk Sitebuilder page sets (see
page 41) or from scratch (see page 44). Learn about the types of single pages offered
by Plesk Sitebuilder in Types of Pages (on page 41).
If you do not want a page set to be available to a customer, you just exclude it from the
customer's service plan. Note that 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 a newly created page set
out to your customers, you should add it to the list of available page sets in the corresponding plans (see page 45). If creating custom page sets is allowed to you, then your
dependent resellers also have this option. Your dependent resellers cannot edit or
remove your custom page sets.
To proceed to managing page sets, go to Server > Page Sets.
40 Setting Up and Maintaining Plesk Sitebuilder
For information on how to operate with list objects, see Working with Lists (on page 21).
In this section:
Types of Pages ................................ ................................................................ . 41
Creating Page Set Using Existing One as Template .......................................... 41
Creating Page Set from Scratch ........................................................................ 44
Editing Page Set ............................................................................................... 44
Specifying Page Sets Available to Certain Users .............................................. 45
Removing Page Set .......................................................................................... 45
Figure 24: Page Sets Management Screen
Setting Up and Maintaining Plesk Sitebuilder 41
Types of Pages
When creating a page set, you can use the following types of pages:
Standard (common) pages - ordinary pages used for displaying text information.
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 your own text content
into it.
Note: The Flash Intro module is the only page module that requires no PHP on
the publishing location and therefore can be included into a static site.
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 service plan.
Creating Page Set Using Existing One as Template
To create a new page set on the basis of an existing page set:
1 On the navigation pane, click Server.
2 Click Page Sets.
42 Setting Up and Maintaining Plesk Sitebuilder
3 In the list of available page sets, click the Clone icon against the
page set you want to take as a basis.
Figure 25: Creating a Page Set: Adding Pages
4 In the Code field, provide a unique code for the page set.
5 In the Title field, specify a name for the page set.
Under this title the page set is displayed to your users in their Administrator Panels
and on the Pages step of the Wizard.
6 To add pages to page set, select them in the Special pages area and
click Add.
7 To change the position of a page, select it in the Page set structure area
and use one of the buttons in the Page position area:
To move a page from the second level to the top level of the site structure, click
Left.
To move a page from the top level to the second level, click Right.
To move a page up at the same level, click Up.
To move a page down at the same level, click Down.
8 To remove a page from the page set, select it and click Delete.
9 To edit the title and content of a page as they appear in the Wizard,
click the page name in the Page set structure box.
The page settings will be available for editing in the Page info area.
Setting Up and Maintaining Plesk Sitebuilder 43
10 Click OK.
Figure 26: Creating a Page Set: Setting Up Pages
Note: For special pages (modules) you cannot edit the page content, only the title.
44 Setting Up and Maintaining Plesk Sitebuilder
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.
The code is used to identify a page set in Plesk Sitebuilder. It can be any arbitrary
alphanumeric combination, but it must be unique for every page set.
5 In the Title field, specify a name for the page set.
Under this title the page set is displayed to your users in their Administrator Panels
and on the Pages step of the Wizard.
6 To make up the list of pages to be included in the page set, select the
desired pages in the Special pages box and click Add.
7 To change the position of a page, select it in the Page set structure area
and use one of the buttons in the Page position area:
To move a page from the second level to the top level of the site structure, click
Left.
To move a page from the top level to the second level, click Right.
To move a page up at the same level, click Up.
To move a page down at the same level, click Down.
8 To remove a page from the page set, select it in the Page set structure
area and click Delete.
9 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.
10 Click OK.
Editing Page Set
You can edit only your 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.
Setting Up and Maintaining Plesk Sitebuilder 45
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 87). 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 configure page sets available to certain users:
1 Create a special service plan for these users as described in Adding
Plan (on page 87) - or edit an existing plan (which may be already assigned to some users) as described in Modifying Plan (on page 92).
2 In the plan editor, on the Page Sets tab, select the page sets you want
to hide from the plan users and click Remove from plan.
3 On the same Page Sets tab, select the page sets you wish to make
available to users, and click Add to plan.
4 Assign all respective users to this plan as described in Assigning Plan to
User (on page 90).
To configure page sets available to anonymous users, make the respective changes in
the trial plan. For details about setting up a trial plan, see Setting Up Service Plan for
Anonymous Users (on page 73).
Removing Page Set
Note that you cannot delete built-in Plesk Sitebuilder page sets, including the ones
created by your Plesk Sitebuilder administrator. You also cannot delete your custom
page set if it is the only page set included in one 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.
46 Setting Up and Maintaining Plesk Sitebuilder
Managing Site Templates (Site Families)
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. If it is allowed by the Plesk
Sitebuilder license, you can create your own site families and offer them to your users.
Site families that go with your service plan cannot be edited or removed from Plesk
Sitebuilder. If you do not want a site family to be available to a customer, you just
exclude it from the customer’s service plan. Note that 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 a newly created site family out to your customers, you should add it to the list of available site families in the corresponding plans (see page 87).
If creating custom site families is allowed to you, then your dependent resellers also
have this option. Your resellers cannot edit or remove your custom site families.
To proceed to managing site families, go to Server > Site Families.
For information on how to operate with list objects, see Working with Lists (on page 21).
Figure 27: Site Families Management Sreen
Setting Up and Maintaining Plesk Sitebuilder 47
In this section:
Creating Site Family .......................................................................................... 48
Editing Site Family............................................................................................. 50
Specifying Site Families Available to Certain Users........................................... 50
Setting Default Site Family ................................................................................ 51
Removing Site Family ....................................................................................... 51
48 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 28: Creating a Site Family: Configuring the Appearance
4 On the Appearance tab, provide a unique code for the site family in the
Code field.
5 In the Title field, specify a title for the site family.
Under this name the site family is displayed to your users on the Start page of the
Wizard.
6 If you want to provide a description of the site family, enter your
arbitrary text in the Description area.
This description is displayed below the site family name on the Start page of the
Wizard.
Setting Up and Maintaining Plesk Sitebuilder 49
7 If you want to add an image to be displayed beside the site family
name, upload an image file from your computer.
To upload an image: click Browse, navigate to the image in your local file system,
click Open on the Choose file screen, and then click Upload.
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.
Figure 29: Creating a Site Family: Choosing the Template Category and Page Set
9 From the Template category list, choose a design template category to be
selected by default when a user goes to the Design step of the Wizard.
A category usually contains several design templates for your users to choose from.
To associate a site family with all available design template categories, select All
categories.
10 From the Page Set list, choose a page set to be selected by default
when a user goes to the Pages step of the Wizard.
You can include only one page set in the site family.
11 Click OK.
50 Setting Up and Maintaining Plesk Sitebuilder
Editing Site Family
You can edit only your custom site families.
To edit a custom site family:
1 On the navigation pane, click Server.
2 Click Site Families.
3 Click the name of the site family you want to edit.
4 Make necessary changes.
5 Click OK.
Web sites already created using this site family are not affected.
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 87).
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 87), further in this guide - or edit an existing plan (which
may be already assigned to some users) as described in Modifying Plan
(on page 92).
2 On the Site Families tab, select the site families you want to hide from
the plan users and click Remove from plan.
3 On the same Site Families tab, select the site families you wish to make
available to users 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. Otherwise, the site family becomes inactive (marked with
in the A column), which means that it will be displayed as grayed out on the Start
page of the Wizard and the users assigned to the current plan will not be able to
select it for creating sites.
Note: Make sure not to set an inactive site family as the default one in a plan.
4 Click OK.
5 Assign all respective users to this plan as described in Assigning Plan to
User (on page 90), further in this guide.
If you wish to configure the site families available to anonymous users, make the
respective changes in the trial plan. For details about setting up trial plan, see Setting Up
Service Plan for Anonymous Users (on page 73).
Setting Up and Maintaining Plesk Sitebuilder 51
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 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. Even if inactive in the plan, the default site family remains
active on the Start page of the Wizard. Every plan must contain one default site family
(which can be removed neither from plan, nor, if it is your custom site family, 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 of the plan editor, 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, including the ones
created by your administrator. You also cannot delete your custom site family if it is set
as a default one, or is the only available site family in one of Plesk Sitebuilder plans.
After you delete a 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.
52 Setting Up and Maintaining Plesk Sitebuilder
Managing Modules
Plesk Sitebuilder modules are components which extend the site functionality: Blog,
Guestbook, eShop, and others. The set of site modules you have at your disposal is
regulated by your service plan. Which modules will be available to your dependent
users you define in their service plans. Creating or integrating custom 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 21).
Figure 30: 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 body of the page as a functional block (for
example, Feedback Form).
Setting Up and Maintaining Plesk Sitebuilder 53
Page module is a web page or several web pages added to site structure as a
In this section:
Specifying Modules Available to Certain Users ................................................. 54
Setting Up Area Map Module ............................................................................ 54
Setting Up SitePal Module ................................................................................. 56
Setting Up eShop Module.................................................................................. 57
separate section (for example, Forum).
Site module adds a functionality to a site as a whole (is not visible in the site
structure). For example - Statistics module, which allows site owners to monitor
visitor attendance statistics.
Version. The version of a module.
54 Setting Up and Maintaining Plesk Sitebuilder
Specifying Modules Available to Certain Users
By default, all modules that go with your service plan 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 87) - or edit an existing plan (which may be already assigned to some users) as described in Modifying Plan (on page 92).
2 On the Modules tab, select the modules you want to make unavailable
and click Remove from plan.
3 On the same tab, select the modules you wish to include in the plan,
and click Add to plan.
4 Click OK.
5 Assign all respective users to this plan as described in Assigning Plan to
User (on page 90).
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 73).
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 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 configure the Google Maps API service for your Plesk Sitebuilder account:
1 On the navigation pane, click Server.
2 Click Modules.
3 In the list of modules, click Area Map.
Setting Up and Maintaining Plesk Sitebuilder 55
Figure 31: Setting Up Area Map Module
4 Click the Get a Google Maps API key for current Plesk Sitebuilder URL shortcut.
5 On the Google web site (http://www.google.com/apis/maps/signup.html),
perform the steps required to generate a Google Maps API key.
In the 'My web site URL' field, you specify 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 Click OK.
56 Setting Up and Maintaining Plesk Sitebuilder
Setting Up SitePal 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 Click Modules.
3 In the list of modules, click SitePal.
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.
Figure 32: Setting Up Site Pal Module
Setting Up and Maintaining Plesk Sitebuilder 57
7 Log in to your affiliate account using the provided credentials.
In this section:
Specifying Payment Systems Available to eShop Owners................................. 58
Setting Up BluePay Affiliate Account ................................................................. 59
Integrating Custom Payment System ................................................................ 61
Once logged in to your account, you may:
Edit your account information and download tax ID forms (This can be found
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 the 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.
58 Setting Up and Maintaining Plesk Sitebuilder
Specifying Payment Systems Available to eShop 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 Click Modules.
3 In the list of modules, click eShop.
4 On the eShop screen, go to the Payment Systems tab.
Figure 33: Specifying Payment Systems Available to E-Shop Owners
5 Disable/enable desired payment system by selecting the check boxes
next to their names.
6 Click OK.
Setting Up and Maintaining Plesk Sitebuilder 59
The selected payment systems appear on the Payment Systems tab on the eShop
module settings in Plesk Sitebuilder Wizard.
For information on configuring additional settings for the BluePay payment system,
refer to Setting Up BluePay Affiliate Account (on page 59).
Setting Up BluePay Affiliate Account
The eShop module is integrated with a built-in form which allows e-shop owners to
register BluePay merchant accounts directly from Plesk Sitebuilder Wizard. You can
enable or disable this option for your site owners. 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.
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.
60 Setting Up and Maintaining Plesk Sitebuilder
Figure 34: 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.
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 the following credentials as well:
API Account ID
Secret Key
Setting Up and Maintaining Plesk Sitebuilder 61
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.
Integrating Custom Payment System
Plesk Sitebuilder eShop module supports the following online payment systems:
You can configure the list of online payment systems available to site owners (see page 58)
and, if necessary, 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 your custom payment system - to obtain
information about required parameters and parameters' names syntax.
To obtain the sample web applications developed by Parallels, 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\PHP\CustomPaymentSystem folder. This folder contains sample applications allowing you to perform test
integration with BluePay (in the BluePay folder, file entryPoint.php), or
Authorize.Net (in the AuthorizeNet folder, file entryPoint.php) payment system.
In the BluePay folder, you will also find a reference file containing the description of
classes used in BluePay API (BluePay.php).
To integrate Plesk Sitebuilder with a custom payment system:
1 On the navigation pane, click Server.
2 Click Modules.
3 In the list of modules, click eShop.
4 On the eShop screen, go to the Custom Payment System tab.
62 Setting Up and Maintaining Plesk Sitebuilder
Figure 35: 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 in 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.
The application must be accessible from Plesk Sitebuilder server via HTTP.
8 In the Request method field, 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 Perl-compatible regular
expression used to define a successful transaction.
You can include a named group confirmationId in this regular expression. In
this case, the regular expression will obtain a transaction ID of the order in the
payment system and place it in the order comment.
For example, /confirmationIdentifier=(?P<confirmationId>.+)/
10 In the Negative result expression field, specify a Perl-compatible regular
expression used to define a failed transaction.
Setting Up and Maintaining Plesk Sitebuilder 63
If you include a named group errorText in this regular expression, it will obtain
the error message from the payment system specifying the reasons of the failure
(failed authorization, invalid credit card number, etc.), place it in the order comment
in Plesk Sitebuilder, and display it to the buyer in the online store.
For example, /errorMessage=(?P<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.
Figure 36: 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 output text is
displayed in 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 separator. Leading and trailing zeroes are not supported.
Note: In the HTTP request, the decimal separators in all numbers are
converted to points.
Integer - allows entering an integer number (positive, negative, or zero).
64 Setting Up and Maintaining Plesk Sitebuilder
Numeric - allows entering a positive integer number, or zero (only numbers
are allowed).
Currency - allows entering a floating point number. Leading and trailing
zeroes are not supported.
Note: In the HTTP request, the decimal separators in all numbers are
converted to points.
Date - allows entering a date. A user enters the date in three different fields
(Month number, Day of the month, Year). The final date record is formed in
format mm/dd/yyyy, with a slash ("/") as a separator.
Phone - allows entering an international phone number. May contain
numbers, spaces, parenthesis, "+" and "-" symbols.
Password - allows entering any arbitrary text string.
CAPTCHA - is intended for protection of online stores against form spamming
(requires entering a confirmation code from the provided image). The results
of the test are presented as 1 (test passed) or 0 (test failed).
For all data types, values are presented in the HTTP request as is, unless
otherwise specified.
5. To specify whether the field is required for filling in or optional, select or clear
the Required check box.
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.
Plesk Sitebuilder suggests a default set of parameters for this section, which you
can use or edit as desired.
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 37: Integrating Custom Payment System: Specifying Parameters to Be Taken
Plesk Sitebuilder suggests a default set of parameters for this section, which you
can use or edit as desired.
1. To add a new parameter, click Add New.
from Placed Orders
Setting Up and Maintaining Plesk Sitebuilder 65
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 ID of the order in the orders index of a particular Plesk
Sitebuilder eShop copy
Site ID. The ID of the order originating site in Plesk Sitebuilder
Shop ID. The ID of the order originating eShop copy in Plesk Sitebuilder (one
site may contain several eShop modules)
Site owner GUID. The GUID (Globally Unique Identifier) of the site owner
generated by Plesk Sitebuilder
Site owner user name. The Plesk Sitebuilder user name of the site owner
Order amount. The amount of the order (without the shipping cost)
Order total. The amount of the order, with the shipping cost included
Order shipping cost. The shipping cost of the order
Currency ISO code. The ISO code of the order currency
14 Click OK.
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 Plesk Sitebuilder Wizard and create a site containing the eShop
module.
3 Go to the Payment Systems tab.
4 Enable the payment system you want to test and specify your account
credentials.
5 Publish the site by specifying the publishing settings and clicking
Publish on the Publish step of the Wizard.
The publishing procedure is described in detail in Plesk Sitebuilder for Linux/Unix Wizard User's Guide (http://www.parallels.com/en/products/sitebuilder/docs).
6 Go to the site by clicking Visit Site on the Publish step of the Wizard.
7 Navigate to the e-shop page and "buy" one of the products choosing
the tested payment system as the payment method.
In case of a successful transaction, the order status is changed 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.
66 Setting Up and Maintaining Plesk Sitebuilder
In case of a declined transaction, the order status is changed 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.
Specifying Hosts Used for Publishing
Sites
In Plesk Sitebuilder, user sites can be published:
To remote FTP servers (including servers running Parallels Plesk for Windows or
Parallels Plesk for Linux/Unix). 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 VPS publishing mode in user
site publishing settings.
To local Plesk Sitebuilder server using XCOPY technology. This option
corresponds to the XCOPY publishing mode in site publishing settings.
We recommend using XCOPY technology for publishing on local Plesk Sitebuilder
host only, as this method is insecure and requires writing permissions on the
specified publishing location.
The maximum number of hosts you can register in Plesk Sitebuilder is determined by
your license (navigation pane > Server > License Management > Plan Info tab).
Depending on the number of available hosts, there can be two ways of introducing a
new publishing host to Plesk Sitebuilder:
If the maximum number of hosts is Unlimited, you (and your dependent users with
access to site publishing settings) can publish sites to any FTP server at their
disposal. To publish site to a host, you do not need to register it in Plesk Sitebuilder
- just to specify it in the site publishing settings (see page 99). After you save the site
settings, the server is automatically registered as a Plesk Sitebuilder host.
If the maximum number of hosts is limited, then to be able to publish a site to a
remote host you need to first register the host in Plesk Sitebuilder (see page 68).
Note: In the basic Plesk Sitebuilder license, only one host is available. To be able to
publish sites to more than one remote servers, contact Parallels sales
(sales@parallels.com) for additional license with Multi Server Publishing support
included.
With Multi Server Publishing license, you - and your users whom you allow to modify
site publishing settings - can publish sites to any FTP servers or Virtuozzo containers
at their disposal.
To access the host management functions, from the navigation pane, go to Server ->
Hosts.
Setting Up and Maintaining Plesk Sitebuilder 67
Figure 38: Hosts Management Screen
In this section:
Requirements to Host ........................................................................................ 68
Removing Host from List of Available Hosts ...................................................... 70
For information on how to operate with list objects, see Working with Lists (on page 21).
Prior to publishing dynamic sites to a host, make sure that this host meets all Plesk
Sitebuilder requirements. To do so, read Requirements to Host (on page 68), further in
this section, and install and configure the described components.
68 Setting Up and Maintaining Plesk Sitebuilder
Requirements to Host
The requirements imposed upon a publishing server depend on the type of sites to be
published on this server: static or dynamic.
In Plesk Sitebuilder, a static site is a site which contains only static HTML pages
created with the help of WYSIWYG editor, and does not contain modules - except for
the Script and Flash Intro modules. There are no special requirements to a host used
for static sites publishing.
A dynamic site is a site with dynamic pages: a site containing at least one module
(except for the mentioned Script and Flash Intro).
To guarantee correct operation of dynamic sites, make sure that the publishing server
meets the following requirements:
PHP version 4.3.9 or later is installed on the publishing server.
PHP supports:
The ionCube PHP Loader 3.1.15 or later
DOM XML with XSLT support or PHP XSLT extension (Sablotron)
Multibyte string functions (mbstring extension)
Zlib compression functions (zlib extension)
Session handling functions support (session extension)
SQLite 2.x with UTF-8 encoding support
GD library 2.0.1 or later
In php.ini the following directive is installed:
default_charset = ”UTF-8”
Note: Make sure that all extensions you have installed are listed in the extensions
directory and in the php.ini file. If PHP is installed as an Apache module, restart
Apache after applying the changes.
Having installed and configured all the necessary components, you can check the
publishing availability of the host. To do so, create a site in your Administrator Panel (see
page 99), go to the Publishing Settings tab, specify the settings for publishing to the
required host and click Verify Location. If any issues occur, you will see detailed warning
or error messages in your Administrator Panel.
For information on resolving typical issues occurring on the publishing location, see
Appendix. Troubleshooting Plesk Sitebuilder (on page 109).
Adding Host
Prior to adding a host, read the requirements (see page 68) a publishing location must
meet in order to ensure successful publishing and correct operation of the published
sites.
Setting Up and Maintaining Plesk Sitebuilder 69
To add a host:
1 On the navigation pane, click Server.
2 Click Hosts.
3 Click Add New Host.
Figure 39: Adding a Publishing Server
4 In the Host DNS name or IP address field, enter a host DNS name (without
the http:// prefix) or IP address.
5 Click OK.
70 Setting Up and Maintaining Plesk Sitebuilder
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 87) - or edit an existing plan (which may be already assigned to some users) as described in Modifying Plan (on page 92).
2 On the Hosts tab, select the hosts you want to make unavailable and
click Remove from plan.
3 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.
4 Click OK.
5 Assign all respective users to this plan as described in Assigning Plan to
User (on page 90).
Note: When you include a host in a service plan, make sure that the corresponding
publishing mode (FTP, VPS, or XCOPY) is enabled in this plan (Publishing Settings tab).
Modifying Host Settings
To modify the host DNS name or IP address:
1 On the navigation pane, click Server.
2 Click Hosts.
3 Click the name of the host you want to edit the settings for.
4 Modify the DNS name or IP address as desired.
5 Click OK.
Removing Host from List of Available Hosts
You can exclude a server from the list of hosts available for site publishing by deleting
it from Plesk Sitebuilder. As a result, the deleted host is removed from the list of hosts
on the Hosts page, from all plans containing it and from the settings of the sites
scheduled for publishing on this host.
Note that sites already hosted on a removed server remain active, but cannot be
republished 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.
Setting Up and Maintaining Plesk Sitebuilder 71
Setting Up Plesk Sitebuilder Wizard for
In this section:
Distributing Link to Plesk Sitebuilder Demo Version .......................................... 72
Setting Up Service Plan for Anonymous Users ................................ .................. 73
Setting Language and Skin for Anonymous User Sessions ............................... 74
Configuring Advertising Banner Shown on Trial Sites ........................................ 75
Setting Up Message Displayed at Publish Step of Wizard ................................. 77
Configuring Notification Message Sent at Trial Site Publishing Attempt ............. 79
Inserting Macros, Links, and HTML Code into Notification Message ................. 80
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 (see Distributing Link to Plesk Sitebuilder Demo Version (on page 72)).
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.
72 Setting Up and Maintaining Plesk Sitebuilder
Distributing Link to Plesk Sitebuilder Demo Version
You can promote your Plesk Sitebuilder service by providing your potential customers
with anonymous access to Plesk Sitebuilder Wizard, where they can create trial web
sites. Thus, you give them a chance to try out the software before they decide to get a
Plesk Sitebuilder account and purchase hosting services from you. To provide them
with such access, supply them with the unique promotional link to Plesk Sitebuilder
Wizard, which is automatically generated by Plesk Sitebuilder for your account.
To obtain this link, go to navigation pane > Server > Trial Sites Settings > Advertising Banner tab.
Figure 40: Obtaining the Link to Plesk Sitebuilder Demo Version
When your customers follow this promotional link, the trial sites they create are
identified as those belonging to your account, and appear on the Sites screen of
your Administrator Panel with a special record (Anonymous-your user name) in the
Owner field. Later, you can assign these sites to their creators (after they purchase
regular user accounts from you), or to your own account, and thus upgrade them to
regular.
Setting Up and Maintaining Plesk Sitebuilder 73
For you and each of your dependent resellers, a separate promotional link is
generated.
Note: Make sure to provide your potential customers with the promotional link which
you see on the Advertising Banner tab, instead of the general Plesk Sitebuilder Wizard
link (http://Sitebuilder_host/wizard). Otherwise, the trial sites your visitors create
are assigned to the Plesk Sitebuilder administrator's account and are not visible or
manageable in your Administrator Panel.
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.
The presence of trial plan in the system actually makes Plesk Sitebuilder available for
anonymous users. By default, Plesk Sitebuilder has no plans configured, so to provide
anonymous users access to Plesk Sitebuilder, you should create at least one plan,
which will be automatically set as a trial plan. If you wish to restrict anonymous access
to the Wizard, you can delete the trial plan after you create some more plans in the
system.
For more details on using plans, see section Setting Up Service Plans (on page 85).
To set up the service plan for anonymous Wizard users:
1 On the navigation pane, click Users.
2 Click Plans.
3 Click Add New Plan, set up the new plan according to your needs.
On the General tab, specify the number of pages and root level pages an
anonymous user can create on his or her trial site.
On the same General tab, specify the required life-time period for trial sites using
the Trial sites lifetime field and drop-down list.
On the Templates, Page Sets, Modules and Site Families tabs, specify the Wizard
presets and modules available to anonymous users. To do so, select the
corresponding entries in the list and click Add to plan or Remove from plan. For
more details on creating plans, see section Adding Plan (on page 87).
Note: For anonymous users, the publishing servers you allow on the Hosts tab, and
the settings and permissions specified on the Publishing Settings tab, are ignored.
4 Click OK.
5 On the Plans screen, select the check box beside the new plan and
click Set as Trial Plan.
The trial plan is indicated with color in the list of plans.
74 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 41: Setting Language and Skin for Anonymous User Sessions
4 From the Skin list, select the desired skin.
5 From the Language list, select the desired language.
The set of languages available to you is determined by your Plesk Sitebuilder
administrator. If you wish to obtain extra language packs, contact your Plesk
Sitebuilder administrator for assistance.
6 Click OK.
Setting Up and Maintaining Plesk Sitebuilder 75
Configuring Advertising Banner Shown on Trial Sites
In Plesk Sitebuilder, you can 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 box, specify the desired text.
Figure 42: Configuring Advertising Banner Shown on Trial Sites
6 Click OK.
76 Setting Up and Maintaining Plesk Sitebuilder
Besides text, you can insert the following elements in the body of advertising banner
message:
Macros (see page 80)
HTML code (see page 81)
Hyperlinks (see page 82)
E-mail links (see page 83)
Setting Up and Maintaining Plesk Sitebuilder 77
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 register. This message also contains general
information about their site, including site’s URL and life-time 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 the message displayed at the Publish step of Plesk Sitebuilder Wizard:
1 On the navigation pane, click Server.
2 Click Trial Sites Settings.
3 Click the Publish Step Message tab.
Figure 43: Setting Up Message Displayed at Publish Step of Wizard
4 If you wish to set your notification message in a different language,
select the desired language from the Language list.
5 In the text box, specify the information you want to deliver to
anonymous users.
78 Setting Up and Maintaining Plesk Sitebuilder
6 Click OK.
Besides text, you can insert the following elements in the body of the message:
Macros (see page 80)
HTML code (see page 81)
Hyperlinks (see page 82)
E-mail links (see page 83)
Setting Up and Maintaining Plesk Sitebuilder 79
Configuring Notification Message Sent at Trial Site
Publishing Attempt
After creating a trial site, on the Publish screen of the 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 or
edit as desired.
To configure the autoreply message sent to anonymous users on trial site publishing
attempt:
1 On the navigation pane, click Server.
2 Click Notifications.
Figure 44: Setting Up E-mail Message Sent at Trial Site Publication Attempt
80 Setting Up and Maintaining Plesk Sitebuilder
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 Notice text field, edit the default text of the notification message
as desired.
7 Click OK.
Besides text, you can insert the following elements in the body of the notification
message:
Macros (see page 80)
HTML code (see page 81)
Hyperlinks (see page 82)
E-mail links (see page 83)
Inserting Macros, Links, and HTML Code into
Notification Message
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.
There are currently four macros in Plesk Sitebuilder:
%siteid - replaced by the site URL
%lifetime - replaced by a site life-time period specified in this user's service plan
%sitepreviewlink - replaced by link to a site in the preview mode
%siteeditlink - replaced by a 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 Macros list on the WYSIWYG
toolbar.
3 Click OK.
Setting Up and Maintaining Plesk Sitebuilder 81
Inserting HTML Code
The default user notification message provided by Plesk Sitebuilder is in HTML format.
If you are not satisfied with the content or formatting of the message, you can edit the
HTML code of the notification.
To format notification message in HTML mode:
1 Place the cursor anywhere in the body of the message.
2 Click Source on the WYSIWYG toolbar.
3 In the Source window, edit the HTML code as desired.
Changes are displayed immediately in the body of the message.
4 Click OK.
82 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 icon on the WYSIWYG toolbar.
3 On the Link Info tab, select URL from the Link type list.
4 From the Protocol list, select the required protocol (http, ftp, or other).
5 In the URL field, enter the web address to which the link will point.
6 On the Target tab, select the way the link should open:
To open the link in the same browser window, leave the Target option in its
default meaning <not set>, and leave the Target Frame Name field blank.
To open the link in the new browser window, select New Window [_blank] from the
Target list.
To open the link as a pop-up window, select <popup window> from the Target list,
and specify the parameters of the pop-up in the Popup Window Features area
below.
Note: Other options in the Target list have been designed to work with the HTML
Frames technology, which is currently not used on Plesk Sitebuilder sites.
On non-frames sites, all these options open the link in the same window.
7 If you wish to specify additional attributes for the hyperlink, enter
them on the Advanced tab:
Id, this attribute assigns a name to the link. This name must be unique on the
page.
Language Direction, this attribute specifies the base direction of text. Direction can
be Left-to-right or Right-to-left.
Access Key, this attribute assigns an access key to an element. An access key is
a single character from the document character set.
Name, this attribute names the current link as an anchor, so that it may be the
destination of another link. The value of this attribute must be a unique anchor
name within the current page.
Language Code, this attribute specifies the base language of the link's attribute
values and text content.
Tab Index, this attribute specifies the position of the current element in the
tabbing order for the current document. The tabbing order defines the order in
which elements receive focus when navigated by the user via the keyboard. The
tabbing order may include elements nested within other elements.
Advisory Title, this attribute offers advisory information about the hyperlink. The
information is displayed in the status bar of the browser when the mouse hovers
over the link.
Advisory Content Type, this attribute gives an advisory hint as to the content type
of the content available at the link target address. It allows user agents to opt to
use a fallback mechanism rather than fetch the content if they are advised that
they will get content in a content type they do not support.
Setting Up and Maintaining Plesk Sitebuilder 83
Stylesheet Classes, this attribute assigns a CSS class name or set of class names
to the link.
Linked Resource Charset, this attribute specifies the character encoding of the
resource designated by the link.
Style, this attribute specifies style information for the current link. The information
should be formatted as follows: Content-Style-Type: text/css.
8 Click OK.
Inserting E-Mail Links
If you want to include a link to a certain e-mail address into your message, insert an email link into the message body.
To insert an e-mail link:
1 Select the text which you want to set as the e-mail link.
2 Click the Hyperlink icon on the WYSIWYG toolbar.
3 On the Link Info tab, select E-mail from the Link type list.
4 In the Address field, type the appropriate e-mail address.
5 In the Message subject field, specify the text that will be placed in the
message subject.
6 In the Message body field, enter the default text you want to be present
in the message.
7 On the Advanced tab, you can specify the additional attributes for the e-
mail link. A full a list of attributes is provided and explained in section
Inserting Hyperlinks (on page 82).
8 Click OK.
This chapter tells how to sign up and manage customers, set up service plans for them,
In this chapter:
Setting Up Service Plans ................................................................................... 85
Signing Up Customers ...................................................................................... 93
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 users.
Plans can be created and managed only by the users with administrator or reseller
accounts. Such users create plans and then assign them to dependent users.
Dependent users (resellers), in their turn, can create their own plans within the limits
set in the plan assigned to them by a higher-level user. For information about creating
user accounts and assigning plans to them, read Signing Up Customers (on page 93).
A plan can also serve as a mean to allow your potential customers to access the
Sitebuilder Wizard without registering an account and try it out for free (see Setting Up Service Plan for Anonymous Users (on page 73)).
To proceed to managing plans, from the navigation pane, go to Users -> Plans.
Figure 45: Plans Management Screen
For information on how to operate with objects in the list, refer to section Working with
Lists (on page 21).
86 Serving Your Customers
In this section:
Adding Plan ....................................................................................................... 87
Assigning Plan to User ...................................................................................... 90
Modifying Plan ................................................................................................... 92
Changing Plan Status ........................................................................................ 92
Removing Plan .................................................................................................. 92
Serving Your Customers 87
Adding Plan
To add a plan:
1 On the navigation pane, click Users.
2 Click Plans.
3 Click Add New Plan.
Figure 46: Creating a Service Plan: Specifying General Settings
4 On the General tab:
In the Name field, specify a name for the new plan.
To easily distinguish this plan from other plans, provide a short description of
the plan in the Description field.
Define the maximum number of:
Pages per site
Root level pages per site
Regular sites
88 Serving Your Customers
User accounts
Hosts
- that the plan assignees are allowed to have.
If you are creating a trial 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 by configuring the Trial sites lifetime parameter.
5 To make up the list of hosts, design templates, page sets, modules,
and site families to be included in the plan, click the respective tabs
(Hosts, Templates, Page Sets, Modules, Site Families) select the necessary
objects and click Add to Plan or Remove from Plan, correspondingly.
Figure 47: 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).
Note: 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. Otherwise, the site family becomes inactive
(marked with in the A column), which means that it will be displayed as grayed
out on the Start page of the Wizard and the users assigned to the current plan will
not be able to select it for creating sites.
6 Go to the Publishing Settings tab.
Serving Your Customers 89
Figure 48: Creating a Service Plan: Configuring Site Publishing Settings
If it is allowed by your service plan, you can allow or disallow your users to
change the publishing settings of their sites - by selecting or clearing the Allow users to modify publishing settings check box.
Users without this permission can publish their sites only after a higher user
specifies the publishing settings for their sites. This permission is necessary for
successful operation of Plesk Sitebuilder resellers.
We do not recommend granting this permission to site owners.
Note: Your dependent users do not inherit this permission from you: even if you
have this permission enabled in your plan, your users cannot edit publishing
settings until you create a service plan with this permission enabled and
assign it to them.
Specify the publishing modes available for users assigned to this plan. The
options are: FTP, VPS, and XCOPY. For information on using these options, see
section Registering Site in System (on page 99).
Note: 1. Which publishing modes are available to you is defined in your service
plan (navigation pane > System Info).
2. If you do not allow the Allow users to modify publishing settings permission in the
plan, be sure to allow at least one publishing mode (FTP, VPS, or XCOPY). For
FTP and VPS modes, be sure to allow the corresponding publishing server on
the Hosts tab of the plan. Otherwise, publishing is impossible for plan
assignees.
7 If it is allowed by your plan, you can include your own promotional
content (or append it to administrator's content, if any) into your users'
site pages. To do so, go to the Promotional Footers tab and enter your
content.
90 Serving Your Customers
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 compound
promotional block (including administrator's content, if any, and yours) is displayed
to all users assigned to this service plan, and to their dependent users.
8 If you wish to let your resellers add their own content to your
promotional footers, select the Allow resellers to append to your promotional footers check box.
Figure 49: Setting Up a Promotional Footer To Be Placed on the Plan Assignees' Sites
Resellers assigned to the current plan cannot edit neither your, nor the
administrator's content. They can append their own content to the existing
promotional footer (containing administrator’s content, and yours), and can in turn
enable or disable this option for their dependent resellers.
Site owners cannot add their content to promotional footers.
9 Click OK.
Note: Every created plan must include at least one design template, page set and
site family.
Assigning Plan to User
To assign a plan to a user:
1 On the navigation pane, click Users.
2 Click the user account you want to assign the plan to.
3 From the Plan list, select a plan.
Serving Your Customers 91
4 Click OK.
Figure 50: Assigning a Service Plan to a User Account
92 Serving Your Customers
Modifying Plan
To modify a plan:
1 On the navigation pane, click Users.
2 Click Plans.
3 Click the name of the plan you want to modify.
4 Make necessary changes in the plan settings.
5 Click OK.
After you have updated the plan parameters, new values are applied to all users to
whom this plan had been assigned.
Changing Plan Status
In Plesk Sitebuilder, a plan can have either activated or deactivated status.
Deactivation of a plan is used for marking those plans which you have assigned to
certain users but don't 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 activated plan and click Deactivate.
4 To activate a deactivated plan, select it and click Activate.
Note: You cannot deactivate a trial plan.
Removing Plan
If you decide that you do not need a certain plan anymore, you can completely remove
it from the system.
Note that if a plan is assigned to some users, it cannot be deleted.
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.
Serving Your Customers 93
Signing Up Customers
In this section:
Creating User Account ...................................................................................... 94
Viewing List of Sites Belonging to User ............................................................. 95
Suspending and Unsuspending User Account ................................................... 95
Changing User Password and Contact Information ........................................... 95
Removing User Account .................................................................................... 96
In Plesk Sitebuilder, regular users are organized in a three-level hierarchy:
administrator, reseller, and site owner.
For those customers who want to resell your Plesk Sitebuilder services, you can create
dependent reseller accounts. Your resellers can in their turn create reseller and site
owner accounts for their customers, and provide them with resources within the limits
you set in their service plans.
Site owner accounts are created for users who want to host and manage their own
sites created in Plesk Sitebuilder Wizard.
To proceed to managing user accounts, click Users on the navigation pane.
Figure 51: User Accounts Management Screen
For information how to operate with list objects, see Working with Lists (on page 21).
94 Serving Your Customers
Creating User Account
To create a user account:
1 On the navigation pane, click Users.
2 Click Add New User Account.
Figure 52: Creating a User Account
3 Specify the contact and login information.
4 From the Role list, select the type of user account (Reseller or Site
Owner).
5 From the Plan list, select a plan which you want to assign to the new
user.
6 If you want to proceed to registering a site for this account
immediately after creating it, select the Proceed to registering a site for this user check box.
Leave the check box cleared if the user has only one regular site allowed in their
plan and has previously created a trial site in Plesk Sitebuilder Wizard. Because in
that case, the user will not be able to upgrade their trial site to a regular one and
continue working with it
For detailed information about creating a new site, refer to section Registering Site in System (on page 99).
7 Click OK.
Serving Your Customers 95
Viewing List of Sites Belonging to User
To view a list of sites belonging to a user:
1 On the navigation pane, click Users.
2 In the list of user accounts, click the List Sites icon in the Sites
column for a user whose sites you want to view.
Suspending and Unsuspending User Account
You can suspend a user account without deleting it completely from the system.
Suspended users are not able to access their Administrator Panels until their accounts
are unsuspended. Users dependent on this suspended user will not be suspended.
To suspend a user account:
1 On the navigation pane, click Users.
2 Select a user account.
3 Click Deactivate.
A suspended account is indicated with the icon.
To unsuspend a user account:
1 On the navigation pane, click Users.
2 Select a suspended user account.
3 Click Activate.
An active user account is indicated with the icon.
After a user account is unsuspended, this user can access Plesk Sitebuilder and
perform the same operations as before suspending.
Changing User Password and Contact Information
To change user's contact information and password:
1 On the navigation pane, click Users.
2 In the list of user accounts, click the user account you want to modify.
3 Make necessary changes and click OK.
96 Serving Your Customers
Removing User Account
After a user account is removed from the system, this user cannot access the
Administrator Panel. If the removed user account has dependent users, these users
will be automatically deleted from the system as well.
To remove a user account:
1 On the navigation pane, click Users.
2 Select the user account you want to remove.
3 Click Delete.
Serving Your Customers 97
Managing Sites
There are two types of sites in Plesk Sitebuilder:
Trial sites - sites created by anonymous users in Plesk Sitebuilder Wizard. These
sites cannot be published on the Internet and have a limited life-time period. You
indicate a life-time period for trial sites in a special service plan for anonymous visits
to the Wizard (for details, read Setting Up Service Plan for Anonymous Users (on page
73)). When the site life-time period expires, a trial site is destroyed.
Regular sites - sites added to the system by registered users. Regular sites can be
published on the Internet and do not have a life-time period. For details on
managing regular sites, read the following subsections.
To proceed to managing sites, click Sites on the navigation pane.
Figure 53: Sites Management Screen
For information on how to operate with list objects, refer to section Working with Lists (on
page 21).
98 Serving Your Customers
In this section:
Registering Site in System ................................................................................ 99
Assigning Trial Site to Your Account ................................................................. 102
Renaming Site ................................................................................................... 103
Changing Site Owner ........................................................................................ 103
Editing Site Publishing Settings ......................................................................... 104
Publishing Site .................................................................................................. 104
Creating Your Own Site in Plesk Sitebuilder Wizard .......................................... 105
Previewing and Editing Site ............................................................................... 105
Promoting Site and Tracking Site Popularity...................................................... 106
Removing Site from Plesk Sitebuilder................................................................ 108
Serving Your Customers 99
Registering Site in System
Note that for users restricted from editing publishing settings (see step 6 in section
Adding Plan (on page 87)) you must specify site publishing settings yourself. Otherwise,
these users will not be able to publish sites.
To register a site:
1 On the navigation pane, click Sites.
2 Click Add New Site.
Figure 54: Registering a Site in the System
If you have already reached the maximum number of sites allowed by your plan, the
Add New Site button is disabled.
3 On the General tab, provide any arbitrary name for the site in the Site
name field.
The name is used to identify the site in Plesk Sitebuilder and is not displayed in
visitors’ web browsers.
4 In the Owner field, specify the name of a registered Plesk Sitebuilder
user the site will belong to.
You will be able to change the owner of a site at any moment.
5 Click the Publishing Settings tab.
100 Serving Your Customers
Figure 55: Registering a Site in the System: Specifying Publishing Settings
If changing site publishing settings is not allowed in your plan, this tab is absent on
the site management screen. In this case, just click OK to register your site.
6 Select the publishing mode for the site: FTP, VPS, or XCOPY.
The list of publishing modes and hosts available to a user you configure in this
user's plan. For details about setting up plans, refer to Adding Plan (on page 87).
Note: VPS publishing mode is used when you publish sites to servers running
Parallels Business Automation, Standard.
7 If you select FTP publishing mode:
In the Host field, enter the IP address or domain name (without the http:// prefix)
of the host to which you want to publish the site.
If the maximum number of hosts allowed by your plan is limited, select a host
from the list. This list contains the hosts included in your service plan (if any),
and the hosts you have registered in your Administrator Panel.
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.