BZRadarPlasmoid Files

TOC:
~~~~

                 I. Getting started
                 II. Compile & Install
                 III. Creating themes




I. Getting started:

        1. Execute the program, search for little red tank icon at the tray icons.
           Right click and open the settings dialog.
        2. Page to the "Clients" and press the "Auto detect" button or add clients manually.
        3. Set the standard notifications...
           E.g.: Page to the "Notifications" and press the "Friends is online" button and write to the first line "#playername is online!".
    4. Page to the Friends and add your friends...
        5. Press Ok and you are done and explore the others :) .


II. Compile & Install:
~~~~~~~~~~~~~~~~~

Compile with GCC 4.4 or above

0. Check, whether Qt SDK installed on your system!

1. If there is not QRossu directory, checkout QRossu next to the po, qt-solutions... directories:

   Command:

        svn checkout svn://svn.code.sf.net/p/qrossu/repo/trunk

2.a run:

   #1 qmake
   #2 make
   #3 make install

2.b Open BZFriends.pro with QtCreator
   #1 Build menu -> build all
   #2 run command in terminal: make install

III. Creating Themes:
~~~~~~~~~~~~~~~

Currently the notification widget, and bzfriends widget are themeable.

Widgets can be themed by QSS language.

 Help:

    http://doc.qt.nokia.com/qq/qq20-qss.html
    http://labs.qt.nokia.com/2007/11/27/theming-qt-for-fun-and-profit/
    http://foss.in/2007/register/slides/Styling_Qt_Using_Style_Sheets_484.pdf
    ftp://ftp.qt.nokia.com/videos/DevDays2007/DevDays2007%20-%20Qt_Styles_and_Style_Sheets.pdf



QSS files located in the "themes" directoy / $themename / *.qss
Place your new theme here as well.

    Objects:
    *************

          1. Notification Interface(That thing usually pops up, notification_intf.qss)



               Description            |     Object name
               ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
               Pager widget           |     notf_pager

               Exit button            |     notf_exit_btn

               Up button              |     notf_up_btn

               Down button            |     notf_down_btn

               No more notification   |     *


                Class names:
               ~~~~~~~~~~~
                - PageWidget
                - TrayPopupWidget
                - JoinNotificationWidget
                - WarningNotificationWidget
                - QListView
                - QToolButton
                - QLabel






          2. BZFriends Interface(Basicly a list, containing your friends, friendslist_intf.qss )

               Description                      |     Object name/Class Name
              ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~


              Status bar ( refresh button, ETA) |  statusbar

              List view friends                 |  lvFriends

              Refresh   button                  |  btnRefresh

              Friends count label               |  lbFriendsCount

              Count down time                   |  lbTime

              Motto text                                | lbMotto

              Callsign text                           | lbCallsign

              Row(Friend's entry)             | PlayerItem (this is a CLASS)