General Dolphin FAQ

​How do I edit the web pages About Us, Contact Us, Privacy, Terms, FAQ?

​How do I edit the Copyright © 2008 Your Company wording at the bottom?

​How can I moderate photos/videos/music uploaded by my members?

​I need to transfer my site to another folder/server. What do I need to do?

​How can I manage affiliates?

​How can I translate my site into a different language?

​How can I manage my banners?

​How can I create a custom page for my site?

---

How do I edit the web pages About Us, Contact Us, Privacy, Terms, FAQ?

The titles and the contents of these pages can be edited in the language file:

Admin Panel -> Settings -> Language Settings -> Search for strings -> Look for here you should search for the corresponding language key and change its value:

• About Us:
  _ABOUT_US_H: About Us Page Title
  _ABOUT_US_H1: About Us Box Title
  _ABOUT_US: About Us Box Contents
  

• Contact Us:
  _CONTACT_H: Contact Us Page Title
  _CONTACT_H1: Contact Us Box Title
  Note: Contact Us Box Contents can be changed in the file contact.php:

  function PageCompPageMainCodeWithForm()
  

• Privacy:
  _PRIVACY_H: Privacy Page Title
  _PRIVACY_H1: Privacy Box Title
  _PRIVACY: Privacy Box Contents
  

• Terms:
  _TERMS_OF_USE_H: Terms Page Title
  _TERMS_OF_USE_H1: Terms Box Title
  _TERMS_OF_USE: Terms Box Contents
  

• FAQ:
  _FAQ_H: FAQ Page Title
  _FAQ_H1: FAQ Box Title
  _FAQ_INFO: FAQ Box COntents
  

---

How do I edit the Copyright © 2008 Your Company wording at the bottom?

This wording can be edited in the language file:

Admin Panel -> Settings -> Language Settings -> Search for strings -> Look for here you should search for the corresponding language key _copyright and change its value

---

How can I moderate photos/videos/music uploaded by my members?

The media files uploaded by your members can be pre- and post-moderated.

Pre-Moderation means that the media won't become available for other members until you approve it.

You can turn on Pre-Moderation as follows:

1) Profile Photos: Settings -> Moderation Settings -> Automatic photo activation after uploading (unchecked)
To approve Profile Photos, navigate to Content -> Profile Photos -> check a photo -> Approve
N.B. You can't disapprove Profile Photos once you approve them.

2) Profile Music: Plugins -> Ray Suite -> pMusic Player -> Settings -> Files auto approving (unchecked)
To approve Profile Music, navigate to Content -> Profile Music -> check an audio file -> Change status
N.B. You can Disapprove/Approve? Profile Music later by changing the status. You can also delete them by clicking the Delete button.

3) Profile Videos: Plugins -> Ray Suite -> Video Recorder -> Settings -> Autoapprove (unchecked)
To approve Profile Videos, navigate to Content -> Profile Videos -> click the Videos link of a user -> click a video icon -> click the Plus sign
N.B. You can't disapprove Profile Videos once you approved them. But you can delete them by clicking the Cross icon.

4) Gallery Photos: Settings -> Advanced Settings -> Enable auto-activation for gallery photos (unchecked)
To approve Gallery Photos, navigate to Content -> Photos -> check a photo -> Change status
N.B. You can Disapprove/Approve? Gallery Photos later by changing the status. You can also delete them by clicking the Delete button.

5) Gallery Music: Plugins -> Ray Suite -> Music Player -> Settings -> Files auto approving (unchecked)
To approve Gallery Music, navigate to Content -> Music -> check an audio file -> Change status
N.B. You can Disapprove/Approve? Gallery Music later by changing the status. You can also delete it by clicking the Delete button.

6) Gallery Videos: Plugins -> Ray Suite -> Video Player -> Settings -> Files auto approving (unchecked)
To approve Gallery Videos, navigate to Content -> Videos -> check a video file -> Change status
N.B. You can Disapprove/Approve? Gallery Videos later by changing the status. You can also delete them by clicking the Delete button.

You can turn on Post-Moderation by checking all the settings above which are marked as (unchecked)

---

I need to transfer my site to another folder/server. What do I need to do?

1) First of all, you need to back up your folders and files and your database tables. It usually results in creation of two archives (.tgz or .zip) which you will have to unpack on your new server/folder; besides, the database tables will have to be imported in your new database.

2) Dolphin 6 has several files which must be changed after transferring to another folder or server:

• inc/header.inc.php change the values of the following variables according to your current settings:

$site['url'] and $dir['root']

and all the elements of $db array (it's not usually needed if you just move your site to another folder on the same server)

• cupid.php, notifies.php, cmd.php files in periodic folder. All of them have lines as follows:

  require_once( '[path_to]/inc/header.inc.php' );
  

where [path_to] must be changed according to the current path to Dolphin folder

Note: You also need to change the paths for each cron running for the above mentioned files.

• ray/modules/global/inc/header.inc.php

edit the line

include("[path_to]/inc/header.inc.php");

the same way as described above

---

How can I manage affiliates?

The Affiliate support must first be enabled by navigating to Admin Panel -> Settings -> Advanced Settings -> Enable affiliate support

Now navigate to Admin Panel -> Users -> Affiliates

Manage Affiliates

On this page you can manage the list of your affiliates by adding and deleting them.

Affiliates can be added in two ways:

• The administrator can manually add all information about a new affiliate;
• A future affiliate can enter this information by creating affiliate profiles on ​http://www.yoursite.com/join_aff.php

After being added the affiliate will be assigned an ID. Then he/she should place a link to your site with this ID. Example: ​http://www.yoursite.com/index.php?idAff=25.

A visitor who has joined your site through this link is automatically assigned to this affiliate and the affiliate will receive a share of all transactions that the visitor initiates (specified in the Percent field).

An affiliate can view his/her statement (list of profiles that are assigned to this affiliate and financial information) by logging in through the following page ​http://www.yoursite.com/aff/

The admin can also view financial statements of each affiliate by clicking the wording fin on the right side of the Manage Affiliates table.

The Affiliate -> My Link section inside an Affiliate Profile will display the link that an affiliate should place at his/her site.

Members as Affiliates

You can give incentives to people that are active members of your community site. This feature is based on Invite a friend module of our script. Members invite their friends using tellfriend.php window (Invite a friend link at the top of the pages). When the invited people registere at the site with the same e-mail they were invited at, they become referrals of the person who invited them.

Admin can set a certain number of invited and registered members (Number of Members) that must be invited before the referrants get eligible to change their membership levels.

The Admin can choose what membership privileges to give to referrants (Memberhip Type) and for how long this privilege should last (Number of Days).

AFF Approved banners

The Admin can insert images for affiliate banners. Affiliates will be able to view them and choose the suitable one for them.

---

How can I translate my site into a different language?

Follow these steps

1. Log into Dolphin's Admin Panel
2. Click Settings -> Language Settings
3. Fill in the name of your New language in the New Language field of the Language File
4. In the Copy from field choose an existing language to copy the language strings from, for example English
5. In the Flag field choose your desired flag for the language you're creating
6. Click Create

This will result with the message * language has been successfully created.
Now you have to compile the language file (write it langs/lang-*.php)

8. In the Language area click Compile next to the language name

This will result with the message * language has been successfully compiled.

9. Open your FTP program
10. Go to your Dolphin directory
11. FTP your new language file from the langs directory on your local computer. The name of the file will look like lang-*.php
12. Open it in a txt editor which supports UTF-8 encoding
13. Make the changes and save it in UTF-8 format.
14. FTP it back (upload) to the lang directory!

Now you need to import your new language strings into the database. Here you can use the following tweak:
​http://www.expertzzz.com/Downloadz/view/2390
Just download it and follow the instructions in the readme.txt file.

---

How can I manage my banners?

Log into your Admin Panel and navigate to Tools -> Banners

On the top of the Banners Panel there is a list of your banners. Each banner in the list has the following controling buttons: Preview, Modify, and Delete.

Preview lets you see the banner as it will look on your site. Modify option lets you change the banner settings. They are stated further. Delete this deletes a banner.

Besides this, every line displays banner statistics, such as number of impressions (views) and number of clicks.

A new banner can be added by using a form at the bottom of the Banners panel. The settings are the same as when you're modifying a banner. Here they are:

1) Banner title - this can be any name you want to assign to your banner. This name won't be shown to members.

2) Banner URL - here you need to specify the link where your banner points to, for example http://www.boonex.com.

3) Banner Active - this checkbox should be checked if you wish to display your banner and unchecked if you want to hide the banner.

4) Banner Text (HTML Only) - this must be the code generating your banner, should it be a picture, a text or an object. For example, the following code will show a BoonEx banner on your site:

<img src="http://www.boonex.com/img/boonex_cse2.gif" />

5) Start Date and End Date are the starting and ending periods of your banner's impression. You can use the Choose and Clear buttons to insert a date and delete it respectively.

6) Position on the page has four checkboxes Top, Left, Bottom and Right to display the banner in the respective areas of your site.

7) HShift and VShift let you specify for what number of pixels you want to shift your Left or Right banners Horizontally or Vertically respectively.

8) Submit button allows you to submit your changes and the Insert as new checkbox lets you submit the modified banner as a new one.

---

How can I create a custom page for my site?

1. For Dolphin versions under 6.1.0

You will need to create three files for your custom page, these files are:

my_page.php templates/tmpl_uni/page_100.html templates/tmpl_uni/css/my_page.css

NB: The names are just examples

1) my_page.php should contain the following lines:

<?php
/***************************************************************************
*                            Dolphin Smart Community Builder
*                              -----------------
*     begin                : Mon Mar 23 2006
*     copyright            : (C) 2006 BoonEx Group
*     website              : http://www.boonex.com/
* This file is part of Dolphin - Smart Community Builder
*
* Dolphin is free software. This work is licensed under a Creative Commons Attribution 3.0 License.
* http://creativecommons.org/licenses/by/3.0/
*
* Dolphin is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
* without even the implied warranty of  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
* See the Creative Commons Attribution 3.0 License for more details.
* You should have received a copy of the Creative Commons Attribution 3.0 License along with Dolphin,
* see license.txt file; if not, write to marketing@boonex.com
***************************************************************************/
require_once( 'inc/header.inc.php' );
require_once( BX_DIRECTORY_PATH_INC . 'design.inc.php' );

$_page['name_index'] = 100; // this is the number of the html page linked with this php file; change it as you wish
$_page['css_name'] = 'my_page.css'; // this is the name of the CSS file linked with the above mentioned HTML file; change it as you wish

$_ni = $_page['name_index'];
$_page_cont[$_ni]['page_main_code'] = PageCompMainCode();

PageCode();

function PageCompMainCode()
{
    // here you should put PHP code to get results if you wish to display something dynamic on this page; for example return $_COOKIE['memberID'];
}
?>

2) templates/tmpl_uni/page_100.html (as soon as you specified 100 in the previous example, this is how you need to name the HTML page) should contain the following lines:

__include _header.html__
    <!-- here you should enter any HTML or Javascript code for your page for example: -->
        <h2 class="my_page">Hello</h2>
    <!-- to display the dynamic content from my_page.php you need to input: -->
        __page_main_code__
__include _footer.html__

3) templates/tmpl_uni/css/my_page.css should contain the following lines:

/* as soon as you're using the my_page class in the previous example, you need to specify it here */

.my_page
{
    color: blue;
}

4) Now you need to make a link to this custom page.

Edit templates/tmpl_uni/_header.html and templates/tmpl_uni/_footer.html and insert the following elements among the other similar ones:

in _header.html

__TOP_MyPage__

in _footer.html

__BMI_MyPage__

Now edit inc/design.inc.php and insert the following lines among the other similar ones:

$_page_cont[0]['TOP_MyPage'] = '<a class="menu_item_link" href="' . $site['url'] . 'my_page.php">' . _t("_MyPage") . '</a>';
$_page_cont[0]['BMI_MyPage'] = '<a class="bottommenu" href="' . $site['url'] . 'my_page.php">' . _t("_MyPage") . '</a>';

Create the language key named _MyPage and you're done.

NB: You may need to create more language keys and write more code depending on the purpose of your custom page.

2. For Dolphin version 6.1.0 and higher

Please refer to this ​Custom Page creation guide.

---

How can I create a language file based HTML block?

1) First you need to create an empty HTML block the way it is described ​here.

2) Open the PageCompose table in phpMyAdmin manager, find the record referring to your newly created page and edit the following columns for it:

Func - should contain the only word PHP

Content - should contain this statement

echo _t("_key_name");

where _key_name is the name of the language key which you will use to refer to this content.

3) Create a key named _key_name in Admin Panel -> Settings -> Language Settings and specify its contents for every language you have installed.