= Cobranding =

This document describes how you can customize the QuteCom to your needs.

== Getting started ==

The easiest way to get started is to create a folder which will contains all your modifications. We will call this folder "brand" in the rest of this document.

Once your folder is created, go to the installation path of your QuteCom ({{{C:\Program Files\QuteCom}}} on Windows) and copy the following folders to the "brand" folder:
 - chat
 - config
 - css
 - pics
 - sounds
 - webpages

When it's done, start the QuteCom with the {{{--resources}}} option. This options takes one parameter: the path to your "brand" folder.

On Windows it goes like this:
{{{
c:\Program Files\QuteCom\QuteCom.exe --resources "c:\path\to\brand"
 
You should see the QuteCom starting as usual.

== Overloading brand names ==

The first modification to try is to set your company and product name.

Edit the file {{{brand/config/branding.xml}}} and replace the value of the {{{company}}} and {{{product}}} with your own company and product names. Restart the QuteCom with the {{{--resources}}} options, you should see the change in the title and menu bars.

== Overloading images ==

To overload images, go to the {{{brand/pics}}} folder and replace any image you like with your images. Sometimes you will need to produce an image of the same dimensions as the original, while in other places the application will adjust to the image size.

== Using Qt stylesheets ==

You can make use of Qt stylesheets system to further customize the application look. To do so, create a file in {{{brand/css/}}}. It can be named like you want (you can even have several files), it only needs to have the {{{.css}}} extension.

Here is an example, copy-paste this to {{{brand/css/brand.css}}}:

{{{
/* Turn the border of all lists to red, and it's background to light gray: */

QLineEdit, QListView, QTreeView, QTextEdit {
	background-color: #eee;
	border: 1px solid red;
	color: black;
}
}}}

For more information, have a look at [http://doc.trolltech.com/4.3/stylesheet.html Qt Stylesheet documentation]

== Overloading configuration values ==

The {{{brand/config/}}} folder contains a few XML files. We have already used {{{branding.xml}}}. An important file in this folder is {{{config.xml}}}. This file contains all the default values of the QuteCom configuration. Have a look at it, try to change some settings.

In this folder you can also find two other files:
 - {{{imaccountparameters.xml}}}: Contains the default settings for IM accounts
 - {{{crashreport.xml}}}: Contains the configuration of the crash report

== Changing the binary name and creating the installer ==

When you are all done, you need to produce an installer for your branded version. To do so you need to:
 - Get the QuteCom source code (see GetTheSourceQuteCom)
 - Replace the {{{qutecom/resources/}}} folder with your {{{brand/}}} folder
 - Recompile the QuteCom (see HowToBuildFromSource), making sure to pass the option: {{{BINARY_NAME=BrandedPhone}}} to CMake.[[BR]]
   This ensures the binary you get is named {{{BrandedPhone}}} ({{{BrandedPhone.exe}}} on Windows)

On Windows, at the end of the process you should get an installer file named {{{BrandedPhone-setup-version.exe}}}.
}}}

















= Sponsors =

[http://www.comprooroinitalia.com quotazione argento usato]
[http://www.bohemjewel.com designer jewelry]
[http://www.comprooroinitalia.com/negozi-compro-oro/compro-oro-lazio/compro-oro-roma/ compro oro roma]
[http://www.comprooroinitalia.com/negozi-compro-oro/compro-oro-lombardia/compro-oro-milano/ compro oro milano]
[http://www.acheapcarinsurance.net cheap car insurance]
[http://www.acarinsurancepolicy.net car insurance policy]
[http://www.acarinsurancepolicy.org car insurance policy]
[http://www.buycarinsurancecheap.net buy cheap car insurance]
[http://www.buycarinsurancecheap.org buy cheap car insurance]
[http://www.carinsurancecheapquote.org cheap car insurance quote]
[http://www.carinsuranceseeker.com car insurance]
[http://www.carinsuranceseeker.org car insurance]
[http://www.carinsurancespin.com car insurance]
[http://www.carinsurancespin.net car insurance]
[http://www.carinsurancetoday.net car insurance]
[http://www.cheapquotecarinsurance.net cheap car insurance quote]
[http://www.cheapquotecarinsurance.org cheap car insurance quote]
[http://www.getbestcarinsurance.net get best car insurance]
[http://www.getbestcarinsurance.org get best car insurance]
[http://www.platinumcarinsurance.net car insurance]
[http://www.platinumcarinsurance.org car insurance]
[http://www.powercarinsurance.com car insurance]
[http://www.powercarinsurance.net car insurance]
[http://www.guadagnareinitalia.com guadagnare online]
[http://www.topcarinsurancequote.org top car insurance]
[http://carinsurancecomparisonhelp.com car insurance comparison]
[http://carinsurancecomparisonshelp.com car insurance comparisons]
[http://carinsurancecompanieshelp.com car insurance companies]
[http://vehicleinsurancefinder.com vehicle insurance]