Parallels Plesk SiteBuilder - 4.5 - Unix Reseller's Guide

Parallels® Plesk Sitebuilder
Copyright Notice
ISBN: N/A Parallels 660 SW 39th Street Suite 205 Renton, Washington 98057 USA Phone: +1 (425) 282 6400 Fax: +1 (425) 282 6444
© Copyright 1999-2008, Parallels, Inc. All rights reserved
Distribution of this work or derivative of this work in any form is prohibited unless prior written
permission is obtained from the copyright holder.
Product and service names mentioned herein are the trademarks of their respective owners.
Contents
Preface 5
About This Guide ........................................................................................................................... 5
Who Should Read This Guide ....................................................................................................... 5
Typographical Conventions ........................................................................................................... 5
Feedback ....................................................................................................................................... 6
About Plesk Sitebuilder 7
Plesk Sitebuilder User Roles ......................................................................................................... 8
Overview of Plesk Sitebuilder Business Logic .............................................................................. 9
What's New in This Version ......................................................................................................... 10
Getting Started with Plesk Sitebuilder 11
Logging In to Plesk Sitebuilder .................................................................................................... 12
Recovering Forgotten Password ....................................................................................... 14
Learning Plesk Sitebuilder Administrator Panel Interface ........................................................... 15
Navigating in Plesk Sitebuilder .......................................................................................... 16
Working with Lists ............................................................................................................. 21
Using Context Help ........................................................................................................... 23
Getting Help ................................................................................................................................. 25
Configuring Settings Related to Your Account 26
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
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
Viewing Information about Your Copy of Plesk Sitebuilder and Service Plan Limitations .......... 34
Setting Up and Maintaining Plesk Sitebuilder 35
Rebranding Your Plesk Sitebuilder ............................................................................................. 35
Setting Up Logo and Title Bar Text ................................................................................... 36
Customizing Help and Support Button Links .................................................................... 36
Viewing and Configuring Plesk Sitebuilder Wizard Presets and Modules .................................. 38
Specifying Site Design Templates Available to Certain Users ......................................... 39
Managing Site Structure Templates (Page Sets) .............................................................. 39
Managing Site Templates (Site Families) ......................................................................... 46
Managing Modules ............................................................................................................ 52
Specifying Hosts Used for Publishing Sites ................................................................................ 66
Requirements to Host ....................................................................................................... 68
Adding Host ....................................................................................................................... 68
Specifying Hosts Available to Certain Users ..................................................................... 70
Modifying Host Settings .................................................................................................... 70
Removing Host from List of Available Hosts ..................................................................... 70
Preface 4
Setting Up Plesk Sitebuilder Wizard for Anonymous Visits......................................................... 71
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
Serving Your Customers 84
Setting Up Service Plans ............................................................................................................. 85
Adding Plan ....................................................................................................................... 87
Assigning Plan to User ...................................................................................................... 90
Modifying Plan ................................................................................................................... 92
Changing Plan Status ....................................................................................................... 92
Removing Plan .................................................................................................................. 92
Signing Up Customers ................................................................................................................ 93
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
Managing Sites ............................................................................................................................ 97
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
Appendix. Troubleshooting Plesk Sitebuilder 109
Typical Site Publishing Errors ................................................................................................... 109
General Publishing Issues .............................................................................................. 110
Known Issues with Third Party Components .................................................................. 111
Preface 5
In this section:
About This Guide ............................................................................................... 5
Who Should Read This Guide ........................................................................... 5
Typographical Conventions ............................................................................... 5
Feedback .......................................................................................................... 6
Formatting
Convention
Type of Information
Example
Special Bold
Items you must select, such as menu options, command buttons, or items in a list.
Go to the Hosts tab. Titles of chapters, sections,
and subsections.
Read the Getting Started chapter.
Preface
About This Guide
This guide instructs you how to set up 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 e­mail notification sent to users after the creation of a trial site.
Serving your customers At this stage, you integrate Plesk Sitebuilder into your business 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
Learning Plesk Sitebuilder Administrator Panel Interface .................................. 15
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).
Figure 1: Logging In to Plesk Sitebuilder
Getting Started with Plesk Sitebuilder 13
In this section:
Recovering Forgotten Password ....................................................................... 14
14 Getting Started with Plesk Sitebuilder
Recovering Forgotten Password
To recover your forgotten password:
1 In your browser's address bar, enter the URL to your Plesk Sitebuilder
Administrator Panel.
For example, http://sitebuilder/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:
Figure 6: Plesk Sitebuilder Desktop Interface Structure
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.
Go to our forum
(http://forum.swsoft.com/forumdisplay.php?s=f2b895fc3636e705ec9b9a85ef81f040
&forumid=99).
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
Limitations ......................................................................................................... 34
C H A P T E R 3
Configuring Settings Related to Your Account
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
Managing Modules ............................................................................................52
Wizard Presets and Modules
Plesk Sitebuilder is shipped with a number of built-in site development presets (templates intended to facilitate the site creation process in 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 (free­of-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:
PayPal Authorize.Net 2Checkout.com BluePay WorldPay
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\CustomPaymentSyste m 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
Adding Host....................................................................................................... 68
Specifying Hosts Available to Certain Users ...................................................... 70
Modifying Host Settings ..................................................................................... 70
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 e­mail 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
Managing Sites ................................................................................................. 97
C H A P T E R 5
Serving Your Customers
and manage web sites.
Serving Your Customers 85
Setting Up Service Plans
In Plesk Sitebuilder, a plan is a set of limits applied to user accounts assigned to it. The general purpose of plans is to regulate distribution of the Plesk Sitebuilder resources, such as hosts, sites, modules, and so on among 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...