Editing QSportsEvent

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

==Introduction==

This is a page that will hold information about the '''QSportsEvent''' app. The initial versions are targeting updated scores and tables for football (soccer). Future versions will include other sports and additional features. The objective of '''QSportsEvent''' is:

''To maximize the experience of following sports events by leveraging the capabilities of the mobile device.''

The data is retrieved from the [http://www.aragon.ws/soccerdb SoccerDB] site. You are encouraged to make donations to that project. The community is encouraged to suggest additional data sources.

The thread to follow on talk.maemo.org is [http://talk.maemo.org/showthread.php?t=49508 QSportsEvent - FIFA World Cup and Football App].

==Installation==

Do '''not''' install '''QSportsEvent''' from [[extras-devel]] at the moment as you are likely to encounter dependency issues. The long story is long, the short story is that Qt apps need PR1.2 to be released.

'''Fremantle (Nokia N900)'''

# Manually uninstall any previous versions first (I've never tested installing on top on an existing one)
# Your database will be replaced, so you will loose all your favourites and all URLs you have entered (I will try to figure out a solution for this...)
# The app does use your Internet connection and there is no 'optimization'. The pages and data downloaded are not huge, so there should not be a big problem, but at least you've been warned...
# There is a dependency on <code>libqt4-webkit</code> and <code>libqt4-xmlpatterns</code>. If you need it, you have to [[root access|be root]] and once you are, you can do:<pre>apt-get install libqt4-webkit</pre>
and
<pre>apt-get install libqt4-xmlpatterns</pre>
# Install the .deb file manually from [http://talk.maemo.org/showthread.php?p=629138#post629138 this post] and launch it from the file manager.

If you don't know how to do that you should probably wait for it to appear in the repositories.

'''Diablo (Nokia 8xx)'''

For Diablo it IS possible to download from Extras-Devel! Some users have reported issues with the 'SQL plugin' (insert link to relevant post here.), however, some are able to use the app.

==User Guide==

#Select
#Favourites
#Matches
#Table
#News<br />This will render the URL that was selected for the current league. Currently, the RSS feed is rendered as 'raw' XML data. Attempts have been made to make it more readable through applying a Cascading Style Sheet (CSS). Due to limited knowledge of CSS, there is more work to do on this, so the community is encouraged to give a helping hand. The current state of the CSS can be found in [http://talk.maemo.org/showpost.php?p=626524&postcount=258 this] post.
#Update Score

Future versions of the User Guide might be written as Google Docs.

==UI Customization==
One of the new features is that the UI will be somewhat 'user configurable'. In Qt, stylesheets can be applied to application widgets. These stylesheets can be read from a file and be changed in runtime. There will be a .qsportsevent/user folder where you can put your own matches.css, table.css, select.css and favourites.css files with the stylesheets to be used in those respective tabs of the application. Instructions as to exactly what and how you can use it can be found in the Qt [http://doc.qt.nokia.com/4.6/stylesheet-syntax.html documentation] and [http://thesmithfam.org/blog/2009/09/10/qt-stylesheets-tutorial/ tutorial]. As an example, it should be possible for you to change the background image (your favourite team's stadium? a team picture? your girlfriend??) and the appearance of the 'matches' and 'table' tables.

Example:
[CODE]
background-image: url(<full path to the image you want to use>);
[/CODE]

In the sample file, the full path is preceeded by a ':' character. You should NOT use it! It is only needed when the item is taken from a Qt resource file. For user customization you will take it directly from the file system, so you shouldn't use that prefix!

The other 'user configurable' feature is the rendering of the RSS feeds. You'll find this file in .qsportsevent/rss.xsl.

Find samples in the attachment. Please note that the default implementation has the same stylesheet for all tabs, so I only attach one example. To be able to upload files to TMO, they have to have an 'acceptable' extension, that's why I had to add .txt. You don't need that on the device.

Please note that upgrades to newer versions of QSportsEvent might delete your files that you store in these folders, so please make sure to keep backups of them in other locations!

Be creative! Share screenshots, xsl, css and image files on the forum! I'm more than willing to change the default ones that come with the application with better looking examples provided by the community!

Please note that this is very experimental! I have barely tested it myself! I include it mainly because I don't want to spend too much time on the appearance of the UI and prefer to concentrate on functionality. Besides, implementing the feature only took 15-20 minutes anyway... Ok, it took longer to write these instructions :)

I can't guarantee that this feature will remain in the app, but I don't see any reason why not...

==Release Plans==

Version '''0.0.5''' (Previous) was downloaded 99 times.

Version '''0.0.6''' (Previous) was released on Tuesday 27th April. The main changes were:

#It is now possible to download full league information from SoccerDB, both current and historical data. Two new 'tabs' are available for that purpose: 'Downloaded Matches' and 'Downloaded Table'.
#It is possible to select the round of matches to look at.
#In the 'favourites' tab it is now possible to select a default league. That will be the one that will be opened when QSportsEvent is launched. 
#Background images should now be correct in all tabs. They were not in 0.0.5.
#This version will NOT be uploaded to Extras-Devel (except for Diablo) due to the well known issue with Qt based applications and the non-release of PR1.2.

Version '''0.0.7 - Stadio Olimpico di Roma''' (Current) was released on Thursday 6th May. The main changes are:

#Much faster download of full league results. Now it should take 3-5 seconds.
#In the 'Downloaded Matches' tab is possible to select by Team as well as by round.
#When a RSS URL is selected, a CSS will be applied to it to render it in a readable fashion.
#Partially user configurable UI using Qt widget stylesheets and XSL for the news page.
#Did I mention live scores?

Version '''0.0.8 - Stamford Bridge''' (Future)

#In the 'Downloaded Table' tab, it should be possible to view the table standings for a specific round, not only the most recent situation.
#New about page, potentially with a link to this Wiki.
#Flag icons instead of country name in the 'regions' of the 'Favourites' tab.
#Bugfix version only.
#This will be the candidate for pushing to Extras-Testing. Help will be needed for testing this one.
#If PR1.2 is released, this might make it to Extras-Devel, but don't count on it too much...

Version '''0.0.9 - San Siro''' (Future)

#Reserve version

Version '''0.1.0 - Santiago Bernabeu''' (Future)

#This is the one for Extras-Testing and (hopefully...) Extras

Version '''0.1.1''' (Future)

#Make use of some features from Qt4.6, most notably portrait mode where it makes sense

Version '''0.1.2''' (Future) and others...
#tbd...

Version '''0.2.0''' (Future)

#This is the 'World Cup ready' version with all the features to allow us to fully enjoy the FIFA World Cup 2010!.

==How to report issues and feature requests==

At the moment, the best way to report issues and suggestion is to post them to the thread on talk.maemo.org or to send an email to qsportsevent@gmail.com.

[[Category:Software]]

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Retrieved from "https://wiki.maemo.org/QSportsEvent"

Personal tools

Navigation

Views

Editing QSportsEvent

@@ Line 8: / Line 8: @@
 The thread to follow on talk.maemo.org is [http://talk.maemo.org/showthread.php?t=49508 QSportsEvent - FIFA World Cup and Football App].
-Please note that by the time the app will hit Extras it will have been renamed to '''MobiTifo'''.
 ==Installation==
-It should now be possible to install MobiTifo/QSportsEvent from [[extras-devel]]! I leave the below, manual installation instructions for the time being until it is confirmed that there are no issues. So far I only have reports from people who already had the app installed. I'd need to know from someone who is doing a 'fresh' install as well.
+Do '''not''' install '''QSportsEvent''' from [[extras-devel]] at the moment as you are likely to encounter dependency issues. The long story is long, the short story is that Qt apps need PR1.2 to be released.
-===Fremantle (Nokia N900)===
+'''Fremantle (Nokia N900)'''
-This description is now OBSOLETE.
 # Manually uninstall any previous versions first (I've never tested installing on top on an existing one)
 # Your database will be replaced, so you will loose all your favourites and all URLs you have entered (I will try to figure out a solution for this...)
 # The app does use your Internet connection and there is no 'optimization'. The pages and data downloaded are not huge, so there should not be a big problem, but at least you've been warned...
-# There is a dependency on <code>libqt4-webkit</code> and <code>libqt4-xmlpatterns</code>. If you need it, you have to [[root access|be root]] and once you are, you can do:<pre>apt-get install libqt4-webkit libqt4-xmlpatterns</pre>
+# There is a dependency on <code>libqt4-webkit</code> and <code>libqt4-xmlpatterns</code>. If you need it, you have to [[root access|be root]] and once you are, you can do:<pre>apt-get install libqt4-webkit</pre>
-# Install the .deb file manually from [http://www.mobitifo.com/qsportsevent_0.0.8_armel.deb this link] and launch it from the file manager. Please note that I am now hosting it on its own site as the size of the .deb file is larger than what I'm allowed to upload as an attachment to a post on talk.maemo.org.
+and
+<pre>apt-get install libqt4-xmlpatterns</pre>
-Please note that, just like with the previous dependency, it seems that the app dies the first time you try to launch it. After that, it should be OK.
+# Install the .deb file manually from [http://talk.maemo.org/showthread.php?p=629138#post629138 this post] and launch it from the file manager.
 If you don't know how to do that you should probably wait for it to appear in the repositories.
-===Diablo (Nokia 8xx)===
+'''Diablo (Nokia 8xx)'''
-For Diablo it IS possible to download from Extras-Devel! Some users have reported issues with the 'SQL plugin'. You might have to install the following packages as well to get it to work:
+For Diablo it IS possible to download from Extras-Devel! Some users have reported issues with the 'SQL plugin' (insert link to relevant post here.), however, some are able to use the app.
-<pre>
-apt-get install libqt4-sql-sqlite2 libqt4-sql
-</pre>
 ==User Guide==
@@ Line 42: / Line 35: @@
 #Matches
 #Table
-#News
+#News<br />This will render the URL that was selected for the current league. Currently, the RSS feed is rendered as 'raw' XML data. Attempts have been made to make it more readable through applying a Cascading Style Sheet (CSS). Due to limited knowledge of CSS, there is more work to do on this, so the community is encouraged to give a helping hand. The current state of the CSS can be found in [http://talk.maemo.org/showpost.php?p=626524&postcount=258 this] post.
 #Update Score
@@ Line 48: / Line 41: @@
 ==UI Customization==
-One of the new features is that the UI will be somewhat 'user configurable'. In Qt, stylesheets can be applied to application widgets. These stylesheets can be read from a file and be changed in runtime. There will be a .qsportsevent/user folder where you can put your own matches.css, table.css, select.css, news.css and favourites.css files with the stylesheets to be used in those respective tabs of the application. Instructions as to exactly what and how you can use it can be found in the Qt [http://doc.qt.nokia.com/4.6/stylesheet-syntax.html documentation], [http://thesmithfam.org/blog/2009/09/10/qt-stylesheets-tutorial/ tutorial] and some [http://doc.trolltech.com/4.4/stylesheet-examples.html#customizing-qtableview examples]. As an example, it should be possible for you to change the background image (your favourite team's stadium? a team picture? your girlfriend??) and the appearance of the 'matches' and 'table' tables.
+One of the new features is that the UI will be somewhat 'user configurable'. In Qt, stylesheets can be applied to application widgets. These stylesheets can be read from a file and be changed in runtime. There will be a .qsportsevent/user folder where you can put your own matches.css, table.css, select.css and favourites.css files with the stylesheets to be used in those respective tabs of the application. Instructions as to exactly what and how you can use it can be found in the Qt [http://doc.qt.nokia.com/4.6/stylesheet-syntax.html documentation] and [http://thesmithfam.org/blog/2009/09/10/qt-stylesheets-tutorial/ tutorial]. As an example, it should be possible for you to change the background image (your favourite team's stadium? a team picture? your girlfriend??) and the appearance of the 'matches' and 'table' tables.
-A good source of images would probably be [http://www.futbolwallpapers.com FutbolWallPapers].
 Example:
-<pre>
+[CODE]
-background-image: url(/home/user/MyDocs/DCIM/20100501_001.jpg);
+background-image: url(<full path to the image you want to use>);
-</pre>
+[/CODE]
 In the sample file, the full path is preceeded by a ':' character. You should NOT use it! It is only needed when the item is taken from a Qt resource file. For user customization you will take it directly from the file system, so you shouldn't use that prefix!
-The other 'user configurable' feature is the rendering of the RSS feeds. You'll find this file in .qsportsevent/user/rss.xsl.
+The other 'user configurable' feature is the rendering of the RSS feeds. You'll find this file in .qsportsevent/rss.xsl.
 Find samples in the attachment. Please note that the default implementation has the same stylesheet for all tabs, so I only attach one example. To be able to upload files to TMO, they have to have an 'acceptable' extension, that's why I had to add .txt. You don't need that on the device.
@@ Line 75: / Line 66: @@
 Version '''0.0.5''' (Previous) was downloaded 99 times.
-Version '''0.0.6''' (Previous) was downloaded 51 times. It was released on Tuesday 27th April. The main changes were:
+Version '''0.0.6''' (Previous) was released on Tuesday 27th April. The main changes were:
 #It is now possible to download full league information from SoccerDB, both current and historical data. Two new 'tabs' are available for that purpose: 'Downloaded Matches' and 'Downloaded Table'.
@@ Line 84: / Line 75: @@
-Version '''0.0.7 - Stadio Olimpico di Roma''' (Previous) was downloaded 81 times. It was released on Thursday 6th May. The main changes were:
+Version '''0.0.7 - Stadio Olimpico di Roma''' (Current) was released on Thursday 6th May. The main changes are:
 #Much faster download of full league results. Now it should take 3-5 seconds.
 #In the 'Downloaded Matches' tab is possible to select by Team as well as by round.
-#When a RSS URL is selected, an XSL will be applied to it to render it in a readable fashion.
+#When a RSS URL is selected, a CSS will be applied to it to render it in a readable fashion.
 #Partially user configurable UI using Qt widget stylesheets and XSL for the news page.
 #Did I mention live scores?
-Version '''0.0.8 - Santiago Bernabeu''' (Current) was released on Saturday 22nd May. The main changes are:
+Version '''0.0.8 - Stamford Bridge''' (Future)
 #In the 'Downloaded Table' tab, it should be possible to view the table standings for a specific round, not only the most recent situation.
-#Chat.
+#New about page, potentially with a link to this Wiki.
-#Predictions.
+#Flag icons instead of country name in the 'regions' of the 'Favourites' tab.
-#UI adjustments.
-#Am. Football, Basketball, Baseball, Icehockey and Tennis live scores.
-#Slightly optimized network utilization
-#New icon and splash screen
-#Ability to update SoccerDB results has temporarily been removed due to lack of tabs...
-Version '''0.0.9 - San Siro or Allianz Stadium''' (Future)
-#Flag icons instead of country name in the 'regions' of the 'Favourites' tab (Makes the .deb too big and thus exceeding the max size allowed to upload to a post on tmo...) .
 #Bugfix version only.
 #This will be the candidate for pushing to Extras-Testing. Help will be needed for testing this one.
 #If PR1.2 is released, this might make it to Extras-Devel, but don't count on it too much...
-Version '''0.1.0''' (Future)
+Version '''0.0.9 - San Siro''' (Future)
+#Reserve version
+Version '''0.1.0 - Santiago Bernabeu''' (Future)
 #This is the one for Extras-Testing and (hopefully...) Extras