Help & Support

Your Cbox embed code is available at your control panel. You need this code to install your Cbox on your website.

Also on that page is your Quick Link — a URL which you can use to access your Cbox directly in your browser or on your mobile device.

Once you have created your Cbox account, go to the Publish page of your control panel. The code and steps for embedding your Cbox are provided there for a number of common platforms.

If you install your Cbox and all you see is code, or nothing at all, your web host may be removing or otherwise interfering with the HTML iframe tags that Cbox uses. Your Cbox code needs to be pasted into an area of your site that accepts HTML without modification. This may mean switching your editor from "rich text" or "WYSIWYG" mode into HTML-editing or "raw" mode, or you may need to open your template files in a plain-text editor like Notepad.

Remember that you always have the option of posting or sharing your Cbox Quick Link — this gives visitors direct access to your Cbox in a full-screen layout, so it's perfect as a mobile option or for stand-alone use.

Go to the Theme editor in your control panel. There you can specify the fonts and colours of your Cbox, using a point-and-click editor. You can always reset your theme to one of the preset defaults there, if you would like to start again.

If you have a Premium or Pro Cbox you can edit CSS, which gives you complete control over presentation.

If you have a Premium or Pro Cbox, you can create a moderator name for yourself at your Users page, and then log in on your Cbox using the "profile" link. You will see a delete icon [x] next to each message in your Cbox, and you will not have to log in at your control panel at all to delete messages.

Alternatively, visit your Messages page to delete messages individually or in bulk. Deleted messages are removed from your public Cbox history, but are preserved in your Archives.

Yes. In the Theme editor, simply delete the colour codes for the main and form background ("BG") elements. This will make the Cbox transparent, allowing whatever is behind the Cbox to show through.

Note that any pop-ups generated by a transparent Cbox will have the default background colour — usually white. If your font colour is light, it may be invisible in popups. You can fix this by editing the CSS to introduce a background-color rule for popups.

Moderation is available on paid Cboxes. Messages on a free Cbox can only be deleted via the control panel only.

You can create a mod or admin name at your Users page, either by selecting one of the existing registered names and clicking the "Mod" button, or by creating a new registered user with Moderator or Administrator status using the form on that page.

To log in with a mod/admin name on your Cbox, enter the name in the "name" box, click the "profile" link at the bottom-right, and then enter the password.

After successfully logging in, you should see [x] and [o] icons next to each message in your Cbox. Clicking the [x] deletes a message, while clicking [o] bans the user that posted the message.

If you are a paid customer with a recurring payment profile (or subscription) at PayPal, then you can cancel it at any time. Your Cbox will not automatically be closed and if you have remaining credit it will continue to work. You will be able to upgrade or renew again manually — this is useful if you want to switch to a longer term.

Cancel an active payment profile with the following steps:

1. Go to PayPal.com and sign in.
2. Go to "Activity" for your transaction history.
3. Search for the email address "paypal@cbox.ws".
4. You should see your latest payment to Cbox. Click to view its details.
5. Locate the link to the profile or subscription on the payment details page.
6. From the recurring profile details, you will be able to cancel your subscription.

If you do not see a link to the profile or subscription from the payment details page, then it may have been a one-off payment with no associated automatic billing.

The "Welcome to Cbox" message appears if there are no other messages to display. You can disable or change it simply by posting a Sticky message.

Note however that the Sticky message differs from the Welcome message in that it remains visible on your Cbox even after other messages have been posted.

Check out the control panel. Cbox is highly customizable, and the options are arranged in the control panel into sections. Some options are only available on paid plans. These will usually be greyed-out. Upgrading will unlock these options, but will not automatically enable them.

Most changes to settings will take effect immediately, but some will require that you refresh the page that your Cbox is on. If you have embedded your Cbox on your website, you will generally not need to reinstall it. Settings that change your embed code will notify you of this.

Cbox Pro provides a very simple API for creating new channels on the fly.

At the Channels page in your control panel you will find your secret API URL. You can open this URL directly in your browser to test it, but it's intended to be called by back-end scripts running on your own site.

The return format for this call is a single line of tab-separated plain-text fields. If there was an error, the first field is "FAIL" and the second field is an error code. If a new thread was successfully generated, the first field is "OK", and the second and third fields are the thread ID and thread key, respectively.

By way of example, this very simple PHP script will generate threads for your Cbox. New threads created via the API will show up in your control panel, but you should store the thread ID and key in your own database as well.

<?php 
$cb_tid = null;
$cb_tkey = null;

$cb_rs = file_get_contents('YOUR_API_URL', 'r');

$cb_rp = explode("\t", $cb_rs);

if ($cb_rp[0] === 'FAIL') {
	// There was an error. 
	// $cb_rp[1] contains the error code
}
else if ($cb_rp[0] === 'OK') {
	// Success
	$cb_tid = $cb_rp[1];
	$cb_tkey = $cb_rp[2];
}
else {
	// Some other error occured.
}

if ($cb_tid && $cb_tkey) {
	// New key generated. Store $cb_tid and $cb_tkey in your database or user session.
	// And insert them into your Cbox HTML code iframe src URLs: 
	// ....&sec=main&tid=<?php echo $cb_tid;?>&tkey=<?php echo $cb_tkey;?>
	// ....&sec=form&tid=<?php echo $cb_tid;?>&tkey=<?php echo $cb_tkey;?>
}
?>