Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

System Administration (ONLY visible/changeable for the administrator of the system) 

If you have a completely installed version of BACKCLICK on your server, you will be able to follow the first steps of System Administration. The installation of the system is described in chapter Installation in this documentation. 

After you have installed the full version of BACKCLICK, you must start configuring your system. Please note that we are only describing the most important settings here. You will find more detailed information in Chapter Installation. 

Ask your administrator for the URL where you will find your installed BACKCLICK, and log in. If possible, use Internet Explorer or Mozilla Firefox. Our example here is: http://doku.backclickasp.de/bc/ This part of the URL — “doku.backclickasp.de” — will differ depending on your company. Please ask your administrator for the correct URL. 

User, Password, and Mandator 

Upon delivery, BACKCLICK will have the super-user “bcadmin” with the password “bcadmin”. You CANNOT delete this user. It will always be part of the standard mandator. 

To log in now, please fill in the administrative user “bcadmin”: 

 

Figure 3.1 - Login View  

Username : bcadmin
Password : bcadmin 
Mandator : <do not fill in for Default-Mandator> 

If “access denied” or another error message appears, please check to see if your password is still appropriate, or if your configuration is completed. Contact your administrator for the new password or the status of the installation. If your installation is completed, you will see your user interface (GUI). On the left-hand side, you will find an overview of your general menu. Clicking on () reveals the main menu to show the submenu, too. Clicking on () hides the respective submenu again. 
To start your configuration of the system, please click on “System Setting” (submenu) in “System-Administration” (main menu). The following entry mask will be shown: (Delivery status): 
 Figure 3.1.1 - Configuration of the System (delivery status) 

Administrator

Fill in the administrator data here, if this has not happened during installation of the system. In case of an emergency, the system will send warnings and status e-mails to this account. 

System E-mail Account

Fill in the data of a POP3 postbox here. This postbox is needed for internal checks. Fields for “SMTP Server #2–#4” are optional. 

Proxy - Server

You may define a (HTTP) Proxy-Server here if necessary. Therefore, you need to confirm the use of a proxy-server once, and leave its address in the field, “Server-address.” If no Proxy-Server will be used, please leave this blank. 
Fig. 3.1.1.1 - System Settings (Part 1 — Examples for Entries) 

IMF Properties

Enter the basic settings of the intelligent e-mail filter (returned e-mail handling) here. These settings define whether those e-mails that have not been filtered should be sent to the administrator of the newsletter, either as an attachment to an IMF e-mail, or as the original returned e-mail. Later on, when you are configuring the basic settings of the IMF, you may define how many of these returned e-mails should be placed in one IMF e-mail (a collection of returned e-mails). This is only possible if they are sent as attached e-mails. 

WebInterface Configuration

The WebInterface is an important component of BACKCLICK. It gives your customers the ability to: 
  • Sign up for your newsletter
  • Unsubscribe to the newsletter
  • Edit their personal profile
  • Share your company’s information with their friends
  • Choose a new password by using the World Wide Web

You can also disable some of these functions, or set a password for all communications between WebInterface and the server. The set password here is “Webinterface” and you should only change it when necessary. The function “recommend” lets your customers sign their friends up for a newsletter. To avoid spam, you should define a period of time in which no e-mail may be sent to the same address. 

URL-Encode

This function encodes links so that special characters will be coded by UTF8. That way, the browser can interpret the links correctly. If you have a second link inside your original link that leads visitors to another website, this second link will also be coded. Example: both links before coding: http://domain.backclick.de?target=http://www.google.de both links after coding: http://domain.backclick.de?target=http%3A%2F%2Fwww.google.de

Authentification Module 

Check here to verify whether an e-mail address is already in your system, signed up as a subscriber. For greater security, you may also define certain IP addresses that are exclusively allowed to use it. In that case, no other IP address can use the authentification module.

HTTP subscriber API 

The “HTTP subscriber API” lets you control the admission of new subscribers, deletion of subscribers, or changes of subscribers for each URL. For greater security, you may also define certain IP addresses that are exclusively allowed to use this function. 

 
Abb. 3.1.1.3 - Konfiguration

Mailer & Plugins

Use these settings to adjust: 
  • The number of BCC subscribers. (You may control this if needed, but not when sending is always personalized.)
  • The controlling frequency. This controls how often the system should be searched for newsletters that are ready to send, and whether or not the IMF-filter (see IMF Basic Settings) should be activated.

 
Abb 3.1.1.4 - Systemkonfiguration (Abschnitt 4 - Beispieleingaben) 
If all settings are entered and you want to save them, please click the button "save", the button "back" will close the current view without any further queries, and will return you to the Main Menu.

Basic Settings (ONLY visible/changeable for the administrator/administrator of mandatory of the system) 

Open the BACKCLICK welcome page for log-in. Enter your mandatory data as described in chapter System Settings. (Be sure to contact your administrator for your personal log-in data.) After you log in, please search your Main Menu for “System Administration.” Click on “Basic Settings” in the submenu. This will open the editing view as illustrated: 
Fig. 3.1.2 - Basic Settings 
To better understand the delivery status

 
Abb. 3.1.2.1 - Grundeinstellungen (Auslieferungszustand; Abschnitt 1) 

Mandatory

This area is only visible for your super-administrator. By switching between different mandator he or she can view and change the mandator's settings. 

Server-Address

Enter the server address (including a port number if it does not equal 80) where BACKCLICK is installed to open the log-in page (GUI). The last sign in the URL should not be a /(slash). In our case we fill in: http://localhost/bc. The second server address shows you where your WebInterface has been installed (usually both addresses should be the same). 

HTML-Editor

You may activate or deactivate the HTML-Editor here. This makes it possible for you to write a newsletter even if you are not able to write or understand HTML-code. When the editor is activated, you can write a text of any length, without keeping the dimensions in mind. BACKCLICK will fit the text to your newsletter, and send it with the correct design.

Default Format Date

The current time may be inserted in e-mail newsletters as a replaceable character. This variable ($$APIDATE$$) may be used in different versions. The six most popular formats for time are predefined, but you can also define a new one. To do this, use the field “Custom Format”. The following variables are available:

 

Symbol 
Bedeutung 
Typ 
Beispiel 
Aera Bezeichner 
(Text) 
AD (n. Chr.) 
Jahr 
(Text & Zahl) 
2000 
Monat des Jahres 
(Zahl) 
Oktober & 10 
Tag des Monats 
(Zahl) 
24 
Stunde in am/pm (1-12) 
(Zahl) 
12 
Stunde des Tages (0-23) 
(Zahl) 
18 
Minute der Stunde 
(Zahl) 
30 
Sekunde der Minute 
(Zahl) 
55 
Millisekunde 
(Zahl) 
987 
Tag der Woche 
(Text) 
Dienstag 
Tag des Jahres 
(Zahl) 
189 
Tag der Woche des Monats 
(Zahl) 
1 (0-basiert -> 1 =
Dienstag) 
Woche im Jahr 
(Zahl) 
27 
Woche im Monat 
(Zahl) 
am/pm Bezeichner 
(Text) 
PM 
Stunde des Tages (1-24) 
(Zahl) 
24 
Stunde in am/pm (0-11) 
(Zahl) 
Zeitzone 
(Text) 
CEST 
Escape für Text 
(Trennzeichen) 
 
einfaches Anführungszeichen 
(Literal) 

 

 Examples:

 

Formatierungsmuster 
Ergebnis 
yyyy.MM.dd G 'um' hh:mm:ss z 
2004.09.05 AD um 03:16:51 CEST 
EEE, MMM d, ''yy 
Sun, Sep 5, '04 
h:mm a 
3:16 PM 
hh 'Uhr' a, zzzz 
03 Uhr PM, Central European Summer Time 
K:mm a, z 
3:16 PM, CEST 
yyyy.MMMM.dd GGG hh:mm aaa 
2004.September.05 AD 03:16 PM 
dd. MMMM yyyy G, HH:mm:ss 'Uhr' 
05. September 2004 AD, 15:16:51 Uhr 

 

 Check your entries by clicking on the help symbol () on the right-hand side of the entry box. You will see the current date/time in the format you chose.

Authentification

 XML content may be imported by BACKCLICK, so that newsletters may be sent from external software. To do this, BACKCLICK assimilates XML data and executes the needed actions. To protect your system against unauthorized access via XML, you should activate the authentification. If the authentification is activated, every piece of XML data must have a valid password for a BACKCLICK user account. For the XML data, the needed attributes are: “NEWSLETTER-AUTHOR-LOGIN” and “NEWSLETTER-AUTHOR-PASSWORD”. 

Spam Check

You may activate the spam-assassin here. This will check the probability that some providers will qualify your e-mails as spam. This is an external range that will just provide some hints about the content of your newsletter, which might be interesting for some providers. If activated, you need to define the server on which the range will run.

...