Skip to content
Snippets Groups Projects
Commit b67c6283 authored by Emmanuel Lepage's avatar Emmanuel Lepage
Browse files

The gitignore was blocking some essential ressource

parent 4609c76e
No related branches found
No related tags found
No related merge requests found
Showing
with 1232 additions and 5 deletions
......@@ -125,11 +125,11 @@ sflphone-client-gnome/stamp-h1
/sflphone-client-kde/*.moc
/sflphone-client-kde/src/moc_*.cpp
/sflphone-client-kde/src/ui_*.h
/sflphone-client-kde/po/
/sflphone-client-kde/po/*
/sflphone-client-kde/doc/
/sflphone-client-kde/man/
/sflphone-client-kde/data/
#/sflphone-client-kde/po/
#/sflphone-client-kde/po/*
#/sflphone-client-kde/doc/
#/sflphone-client-kde/man/
#/sflphone-client-kde/data/
/sflphone-client-kde/CMakeCache.txt
/sflphone-client-kde/CMakeLists.txt.user
/sflphone-client-kde/CTestTestfile.cmake
......
add_subdirectory(icons)
INSTALL( FILES sflphone-client-kde.desktop DESTINATION ${XDG_APPS_INSTALL_DIR} )
INSTALL( FILES sflphone-client-kdeui.rc DESTINATION ${DATA_INSTALL_DIR}/sflphone-client-kde )
INSTALL( FILES sflphone-client-kde.notifyrc DESTINATION ${DATA_INSTALL_DIR}/sflphone-client-kde)
kde4_install_icons( ${ICON_INSTALL_DIR} )
sflphone-client-kde/data/icons/hi128-apps-sflphone-client-kde.png

14.3 KiB

sflphone-client-kde/data/icons/hi16-apps-sflphone-client-kde.png

932 B

sflphone-client-kde/data/icons/hi22-apps-sflphone-client-kde.png

1.34 KiB

sflphone-client-kde/data/icons/hi32-apps-sflphone-client-kde.png

2.28 KiB

sflphone-client-kde/data/icons/hi48-apps-sflphone-client-kde.png

3.86 KiB

sflphone-client-kde/data/icons/hi64-apps-sflphone-client-kde.png

5.65 KiB

File added
File added
This diff is collapsed.
[Desktop Entry]
Type=Application
X-DocPath=sflphone-client-kde/index.html
Terminal=false
Name=SFLphone VoIP KDE4 client
GenericName=Telephone
Comment=Call and receive calls with SIP or IAX protocols
Exec=sflphone-client-kde
Icon=sflphone.svg
StartupNotify=true
Categories=Network;Telephony;
[Global]
Name=sflphone-client-kde
IconName=sflphone-client-kde
Comment=SFLphone VoIP KDE4 client
[Event/contact online]
Name=Contact Online
Comment=A contact has come online
Sound=
Action=Sound|Popup
[Event/test_notification]
Name=test message
Comment=Test message
Contexts=call
Action=Sound|Popup|Taskbar
Persistant=true
Sound=
[Event/test_notification2]
Name=test message2
Comment=Test message2
Sound=KDE-Im-New-Mail.ogg
Action=None
<?xml version="1.0" encoding="UTF-8"?>
<!--<gui name="tutorial3"
version="1"
xmlns="http://www.kde.org/standards/kxmlgui/1.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.kde.org/standards/kxmlgui/1.0
http://www.kde.org/standards/kxmlgui/1.0/kxmlgui.xsd" >
-->
<gui name="sflphone-client-kde" version="1">
<MenuBar>
<Menu name="Actions" >
<text>Actions</text>
<Action name="action_accept" />
<Action name="action_refuse" />
<Action name="action_hold" />
<Action name="action_transfer" />
<Action name="action_record" />
<Action name="action_mailBox" />
<Separator />
<Action name="action_main" />
<Action name="action_history" />
<Action name="action_addressBook" />
<Separator />
<Action name="action_close" />
<Separator />
<Action name="action_quit" />
</Menu>
<Menu name="Settings" >
<text>Settings</text>
<Action name="action_displayVolumeControls" />
<Action name="action_displayDialpad" />
<Separator />
<Action name="action_configureSflPhone" />
<Separator />
<Action name="action_accountCreationWizard" />
</Menu>
</MenuBar>
<ToolBar name="mainToolBar" iconText="icononly" position="Top" noMerge="1" fullWidth="false" newline="true" >
<Action name="action_accept" />
<Action name="action_mailBox" />
<Action name="action_refuse" />
<Action name="action_hold" />
<Action name="action_transfer" />
<Action name="action_record" />
<Action name="action_main" />
<Action name="action_history" />
<Action name="action_addressBook" />
</ToolBar>
</gui>
########### install files ###############
#
#
KDE4_CREATE_HANDBOOK(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR sflphone-client-kde)
<chapter id="advanced-use">
<chapterinfo>
<authorgroup>
<author>
<firstname>J&eacute;r&eacute;my</firstname>
<surname>Quentin</surname>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
</chapterinfo>
<title>Advanced use of &sflphone-client-kde;</title>
<sect1 id="advanced-use-hooks">
<title>Hooks</title>
<para>
An interesting feature of &sflphone; is the hook handle. Hooks designate some actions you can choose to trigger on a particular signal, especially when receiving or sending a call. The two useful hooks that are implemented in &sflphone; are the URL argument, and the phone number formatting.
</para>
<sect2 id="advanced-use-hooks-url">
<title>URL argument</title>
<para>
This feature permits you to grab an URL sent in a particular header of the SIP or IAX message sent by Asterisk server, and execute it with the chosen browser command.
</para>
<para>
To configure it, go to the Hooks page of the configuration menu. Then check the SIP or/and IAX checkbox, if you want to enable hooks with SIP accounts or/and with IAX accounts. Then type the name of custom header that your Asterisk server inserts into the invite message for the SIP protocol (if you don't know the name of the custom header, ask the one who configured the Asterisk server). For IAX there is a common header for that, so you don't have to configure it . Then type the command of the browser you want to have the URL opened with, or leave x-www-browser for the default browser.
</para>
</sect2>
<sect2 id="advanced-use-hooks-formatting">
<title> Phone number formatting </title>
<para>
This feature permits you to add the chosen prefix at the beginning of the phone number you are calling.
</para>
</sect2>
</sect1>
<sect1 id="advanced-use-codecs">
<title>Codecs</title>
<para>
To communicate voice information, &sflphone; uses some codecs. You can choose which codec to use in the audio configuration panel.
</para>
<para>
In this panel you will see the codecs available on your system with all their parameters. &sflphone; will use the first activated one in the list. So you can change the order of the list, and activate/deactivate some ones, to change which one will be used. To do that, select a codec and click on the up/down arrows, or just check/uncheck the corresponding checkbox. It's so simple I wonder why I'm writing that.
</para>
</sect1>
</chapter>
\ No newline at end of file
<chapter id="basic-use">
<chapterinfo>
<authorgroup>
<author><firstname>J&eacute;r&eacute;my</firstname><surname>Quentin</surname></author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
</chapterinfo>
<title>Basic use of &sflphone-client-kde;</title>
<para>Although &sflphone; is enterprise oriented, its interface is very easy to use and you can use the basic features without any particular skills or knowings.</para>
<sect1 id="basic-use-mainwindow">
<title>Presentation of the main window</title>
<para>The main window is composed of three main parts : the &actions-p;, the &screen-p; and the &dialpad-p; (although you can hide the two last ones in the Settings menu). The screen part has three positions.
The &current-w; : it is the one you are by default, it shows the current, dialing and incoming calls.
The &history-w; : it shows the past calls and enables you to call someone you called earlier or from whom you missed a call.
The &address-w; : it enables you to look in the address book of KDE and to call somebody if his number is available.
To switch between those windows, click on the history and address book buttons. If none of these buttons is triggerred, you are currently in the &current-w;, if the history button is triggerred, you are in the &history-w;, and if the address book button is triggerred, you are in the &address-w;.
</para>
</sect1>
<sect1 id="basic-use-call">
<title>Making a call</title>
<sect2 id="basic-use-call-current">
<title>Dialing one's number</title>
<para> If you know the number of the people you want to call, you may just type it on the dialpad or on your keyboard while you are in the &current-w;, then click on the Accept button in the &actions-p;'s toolbar or in the "actions" menu, or type enter on your keyboard, or even double-click on the number to call once you have finished dialing it.</para>
<para>Following behaviour, common part...</para>
</sect2>
<sect2 id="basic-use-call-history">
<title>Calling from call history</title>
<para> If you want to call somebody from whom you missed a call, or you already called earlier, you may go to the &history-w;. The detailed use of this window and its features (search...) is described in this section. Once you are in it, find the number or name of the person you want to call, then select it and click on the Accept button in the &actions-p;'s toolbar or in the "actions" menu, or type enter on your keyboard, or double-click on the number.</para>
<para>The screen will come back to the &current-w; with a new ringing call with the number you chose in the &history-w;.</para>
<para> Note that you can also right click and select Edit before call to modify the number in the history before calling it.</para>
<para>Following behaviour, common part...</para>
</sect2>
<sect2 id="basic-use-call-address">
<title>Calling from address book</title>
<para> If you have your KAddressBook configured and filled with some phone numbers, you can go to the &address-w;. The detailed use of this window and its features (search...) is described in this section. Once you are in it, find the name of the person you want to call with the right phone number (&pt-home;, &pt-work; or &pt-cell;), then select it and click on the Accept button in the &actions-p;'s toolbar or in the "actions" menu, or type enter on your keyboard, or double-click on the number.</para>
<para>The screen will come back to the &current-w; with a new ringing call with the number you chose in the &address-w;.</para>
<para> Note that you can also right click and select Edit before call to modify the number in the address book before calling it.</para>
<para>Following behaviour, common part...</para>
</sect2>
</sect1>
<sect1 id="basic-use-becalled">
<title>Receiving a call</title>
<para> When one of the account registered in &sflphone; receives an incoming call, it will be displayed as a new item in the &current-w; with the "incoming" icon. You can either accept or refuse it. To accept it, select the item and click on the Accept button which replaced the Call button in toolbar and Actions menu, or double click the item, or type Enter. To refuse it, select it and click on the refuse button that replaced the Hang up button in toolbar and Actions menu or type Escape.</para>
<para>Following behaviour, common part...</para>
</sect1>
<sect1 id="basic-use-ringing">
<title>The call is ringing</title>
<para> Once you called a number, the call is normally in ringing state. It will then pass to Current or Busy state, according to the decision of the called peer to accept or refuse the call. If it's in Busy state, you can just hang it up with the Hang up button or typing Escape.
</para>
<para>If the number doesn't exist or if any other error occured (see the list of common errors here), it is in failure state, then you can Hang it up with the Hang up button or typing Escape. </para>
<para>Following behaviour, common part...</para>
</sect1>
<sect1 id="basic-use-current">
<title>The call is current</title>
<para> Once the call is in current state, you can now communicate with your peer. You have a bunch of useful features when in current state that are described in the common use chapter. To end the call, select it and click on Hang up button in toolbar or type Escape. </para>
</sect1>
<sect1 id="basic-use-config">
<title>Configuration panel</title>
<para>The configuration panel is built in accordance with KDE specifications. It is divided by options type. The panel at left shows the different option pages you can reach. Click on one of them to acceed to the corresponding page. The changes you make are not applied until you click OK or Apply. Clicking Cancel will cancel and forget every change you made since the last Apply or OK command. Be careful not to forget some changes you made in some other pages if you wanted to Cancel it. </para>
<para>There is also a specific Apply button just for the account list which is useful to manage these accounts and valid your changes to see if the accounts are well registered. </para>
</sect1>
</chapter>
<chapter id="common-use">
<chapterinfo>
<authorgroup>
<author>
<firstname>J&eacute;r&eacute;my</firstname>
<surname>Quentin</surname>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
</chapterinfo>
<title>Common use of &sflphone-client-kde;</title>
<sect1 id="common-use-current">
<title>Handling a call</title>
<para>There are a bunch of features that you can apply on a current call with &sflphone;. Here are their descriptions.
</para>
<sect2 id="common-use-current-new">
<title>Placing a new call</title>
<para> You can have plenty of calls in parallel, even if only one is current (ie : you can talk through) and the others are on hold. To place a new call when you are on a current call, click on the Place new call button, it will create a new empty item and select it automatically, then type the phone number you want to call and click Call or type Enter to place the call. You can also go to the &history-w; or the &address-w; and valid a call, and it will be added ringing in the &current-w;. When a new call is placed, any other one is put on hold, so that you can't mix two calls. If you want to go back to one of the calls put on hold, just double-click on the corresponding item and it will go back to current state while the old one is put on hold.
</para>
</sect2>
<sect2 id="common-use-current-hold">
<title>Holding a call</title>
<para> If you want to place the current call on hold, you just have to click on the Hold button. The icon of the call will then be changed and communication is paused with your peer. You can then place a new call, transfer the held one (see transf...)... To take the communication back, just double-click on the item or click on Unhold button.
</para>
</sect2>
<sect2 id="common-use-current-transfer">
<title>Transfering a call</title>
<para> If you want to transfer the current call to another phone number, click on the transfer button, the item will change and enable you to type the number to which you want to transfer your peer. Once you've typed it, click on Valid transfer button or type Enter to effectively transfer the call. You can place the call on hold while typing the number (see hold).
</para>
</sect2>
<sect2 id="common-use-current-record">
<title>Recording a call</title>
<para> If you want to record the current call, click on the record button, the button will become triggered and the light may come on. Since &sflphone; only records calls when they are current (ie : not on hold), the light will be on if the selected call is current and can be recorded, and off if it's not. But if the button is triggered, &sflphone; will record as soon as it's communicating.
</para>
</sect2>
</sect1>
<sect1 id="common-use-mailbox">
<title>Call mailbox</title>
<para>You can call your mailbox typing your account's mailbox number. But if you have registered this number in account's settings, you can just click on Mailbox button. It will call the mailbox of the first registered account.</para>
<para> In both case, you can then type your mailbox's password without worrying about people around, since &sflphone; will not display what you type if the called number is the registered mailbox number of the current call's account.
</para>
</sect1>
<sect1 id="common-use-address">
<title>Use the address book</title>
<para>&sflphone-client-kde; communicates with the KDE Address Book and gathers all the phone numbers matching your request and the options chosen. Here we will explain how to configure and use it.</para>
<sect2 id="common-use-address-kde">
<title>Configuring KDE Address Book</title>
<para> As it is fully designed for KDE, &sflphone-client-kde; looks for your contacts in KDE Address Book. So you first have to configure it. In the K Menu of your KDE, go to Applications,then Bureautique (??), then choose Address Book. You are now in the main window of the KDE address book. You can add contacts and handle them from here. Type F1 to see this application's help page if you have some problems with it.
</para>
<para> &sflphone-client-kde; looks into the standard address book, that means it will look into the contacts displayed in the contact list on the left of the window. The selected address books in the bottom left of the window will be searched. If you add some contacts, you may have to restart &sflphone-client-kde; before it can see them.
</para>
</sect2>
<sect2 id="common-use-address-config">
<title>Configuring &sflphone-client-kde;</title>
<para> You can now go to the Configuration Dialog to choose how &sflphone; will handle your searches in the address book. This step is optionnal though, because the default settings enable you to use the feature without more setup.
</para>
<para> The maximum results setting enables you to choose how many phone numbers can be displayed when you look for a contact. KDE address book can contain lots of contacts, especially if connected to LDAP directories, and you don't want to see thousands of contacts displayed as soon as you type a letter to search for.</para>
<para> KDE address book can contain a photo for your contacts. &sflphone-client-kde; can display it in the result of your searches, but as it can take a little more time, you can choose to disable that feature.</para>
<para> Each phone number in KDE address book is linked to a contact, and has a phone number type to differentiate work phones, home phones, and cell phones. You can choose to display only certain of those numbers. Check the types you are interested in and uncheck the other ones.</para>
</sect2>
<sect2 id="common-use-address-use">
<title>Search in Address Book</title>
<para> Now that everything is set up, you can go to the &address-w;, then type some letters of the name you want to phone. You will see all the phone numbers that match your request and their type. When the resulting list's size is greater than the maximum chosen in configuration, it will only display the beginning of the list with the max size, and will display a warning message to let you know that your wanted number may be in the rest of the list and so not displayed. In that case you should type some more letters to improve precision of the search. Once you found the right number, double click on the item to call it.
</para>
</sect2>
</sect1>
<sect1 id="common-use-config">
<title>Configuration Dialog</title>
<para> There are a lot of options in &sflphone;. All of them are gathered and sorted in the Configuration Dialog. You can reach it clicking Configure SFLPhone in the Settings menu. Here are presented some commonly useful options</para>
<sect2 id="common-use-config-address">
<title>General settings</title>
<para> Here you can choose the capacity of the call history.
</para>
</sect2>
</sect1>
</chapter>
\ No newline at end of file
<chapter id="credits">
<title>Credits and License</title>
<!--<itemizedlist>
<title>Program Copyright:</title>
<listitem><para>Albert Astals Cid<email>aacid@kde.org</email> </para></listitem>
<listitem><para>Pino Toscano <email>pino@kde.org</email> Current maintainer</para></listitem>
<listitem><para>Enrico Ros<email>eros.kde@email.it</email> developer</para></listitem>
</itemizedlist>
<itemizedlist>
<title>Documentation Copyright:</title>
<listitem><para>Albert Astals Cid<email>aacid@kde.org</email> Author</para></listitem>
<listitem><para>Titus Laska<email>titus.laska@gmx.de</email> Some updates and additions</para></listitem>
<listitem><para>Pino Toscano <email>pino@kde.org</email></para></listitem>
</itemizedlist>-->
<itemizedlist>
<title>Program:</title>
<listitem>
<para>The initial application were witten by Jérémy Quentin <email>jeremy.quentin@savoirfairelinux.com</email>.
</para>
</listitem>
</itemizedlist>
<itemizedlist>
<title>Documentation:</title>
<listitem>
<para>The initial contents of this manual were witten by Jérémy Quentin <email>jeremy.quentin@savoirfairelinux.com</email>.
</para>
</listitem>
</itemizedlist>
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
&underFDL;
&underGPL;
</chapter>
\ No newline at end of file
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment