added song usage

bzr-revno: 45
This commit is contained in:
John Cegalis 2011-08-04 05:35:01 -05:00 committed by Wesley Stout
commit d35d958aff
8 changed files with 88 additions and 3 deletions

View File

@ -1,6 +1,9 @@
.. _creating_service:
==================
===============
Service Manager
===============
Creating a Service
==================

View File

@ -12,8 +12,7 @@ Getting Started With OpenLP
install_windows_mac
install_linux
install_bsd
creating_service
Reference Manual
----------------
@ -24,6 +23,7 @@ Reference Manual
configure
dualmonitors
mediamanager
creating_service
print_service
plugin_list
display_tags
@ -32,6 +32,7 @@ Reference Manual
songs
bibles
custom_slides
song_usage
alert
glossary

Binary file not shown.

After

Width:  |  Height:  |  Size: 757 B

Binary file not shown.

After

Width:  |  Height:  |  Size: 716 B

Binary file not shown.

Before

Width:  |  Height:  |  Size: 27 KiB

After

Width:  |  Height:  |  Size: 24 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 27 KiB

After

Width:  |  Height:  |  Size: 23 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 55 KiB

After

Width:  |  Height:  |  Size: 46 KiB

View File

@ -0,0 +1,81 @@
.. _song_usage:
Song Usage Tracking
===================
OpenLP gives you the ability to track all the songs that are displayed live.
Every time a song is displayed live it will be logged. This is useful for CCLI
or any other church copyright license that may require tracking or for your own
personal use to know what songs you previously used.
Song Usage Tracking is listed under the menu item
:menuselection:`Tools --> Song Usage Tracking`
.. image:: pics/songusage.png
You can start and stop tracking by using your keyboard :kbd:`F4` key, going to
:menuselection:`Tools --> Song Usage Tracking --> Toggle Tracking` or by using
one of these buttons below :ref:`creating_service`.
|song_active| Song usage tracking is active.
|song_inactive| Song usage tracking is inactive.
**Extract Tracking Data**
Now that you have tracked the songs that were displayed you will want to access
the information. Go to
:menuselection:`Tools --> Song Usage Tracking --> Extract Tracking Data` and you
will be presented with dual calendars.
.. image:: pics/songusagereport.png
**Select Date Range**
The calendars on the left side and right side are what you use to select the
beginning and end dates of your tracking information. Select the date you want
to begin your tracking information on the left and end your tracking information
on the right. Use the left and right arrows or click on the month or year and
then select the day.
**Report Location**
|file_open| Use this button to choose the folder you want to save your tracking
file in. Click :guilabel:`OK` and click :guilabel:`OK` again or
:guilabel:`Cancel` at any time. This saves your tracking log as \usage_detail_"start_date"_"end_date".txt. You can open this file in any text
viewer or your spread sheet application.
The usage detailed report will be in the following format: Year, Month, Day,
Hour, Minute, Seconds, Micro-seconds, Song title, Copyright, CCLI number, Author.
**Delete Extracted Data**
When you do not need your previously saved data past a certain point in time,
you can delete it. Go to
:menuselection:`Tools --> Song Usage Tracking --> Delete Tracking Data`
.. image:: pics/songusagedelete.png
You will be presented with a single calendar. Select a date by using the left
and right arrows or click on the month or year and then select the day. All
tracking information prior to the date you selected will be deleted. Click
:guilabel:`OK` to delete or :guilabel:`Cancel` if you change your mind.
**Tip**
Every time you display a song, whether for practice or during a service, it will
be logged if tracking is on. This could create a lot of duplicate songs being
logged. Toggle the tracking on and off, as needed, at the bottom right under
:ref:`themes` using these buttons.
|song_active| Song usage tracking is active.
|song_inactive| Song usage tracking is inactive.
.. These are all the image templates that are used in this page.
.. |SONG_ACTIVE| image:: pics/song_usage_active.png
.. |SONG_INACTIVE| image:: pics/song_usage_inactive.png
.. |FILE_OPEN| image:: pics/service_open.png