QSportsEvent
(→Introduction) |
(Undo revision 45991 by 114.79.28.10 (Talk) vandalism/spam) |
||
(50 intermediate revisions not shown) | |||
Line 5: | Line 5: | ||
''To maximize the experience of following sports events by leveraging the capabilities of the mobile device.'' | ''To maximize the experience of following sports events by leveraging the capabilities of the mobile device.'' | ||
- | The data is retrieved from the SoccerDB site. You are encouraged to make donations to that project. The community is encouraged to suggest additional data sources. | + | 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]. | ||
+ | |||
+ | Please note that by the time the app will hit Extras it will have been renamed to '''MobiTifo'''. | ||
==Installation== | ==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. | |
+ | |||
+ | ===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> | ||
+ | # 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. | ||
+ | |||
+ | 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. | ||
+ | |||
+ | 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'. You might have to install the following packages as well to get it to work: | ||
+ | <pre> | ||
+ | apt-get install libqt4-sql-sqlite2 libqt4-sql | ||
+ | </pre> | ||
==User Guide== | ==User Guide== | ||
Line 17: | Line 42: | ||
#Matches | #Matches | ||
#Table | #Table | ||
- | #News | + | #News |
#Update Score | #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, 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. | ||
+ | |||
+ | A good source of images would probably be [http://www.futbolwallpapers.com FutbolWallPapers]. | ||
+ | |||
+ | Example: | ||
+ | <pre> | ||
+ | background-image: url(/home/user/MyDocs/DCIM/20100501_001.jpg); | ||
+ | </pre> | ||
+ | |||
+ | 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. | ||
+ | |||
+ | 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 downloaded 51 times. It 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''' (Previous) was downloaded 81 times. It was released on Thursday 6th May. The main changes were: | ||
+ | |||
+ | #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. | ||
+ | #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: | ||
+ | |||
+ | #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. | ||
+ | #Predictions. | ||
+ | #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) | ||
+ | |||
+ | #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== | ==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. | + | 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]] |
Latest revision as of 06:25, 15 December 2011
Contents |
[edit] 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 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 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.
[edit] 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.
[edit] 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
libqt4-webkit
andlibqt4-xmlpatterns
. If you need it, you have to be root and once you are, you can do:apt-get install libqt4-webkit libqt4-xmlpatterns
- Install the .deb file manually from 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.
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.
If you don't know how to do that you should probably wait for it to appear in the repositories.
[edit] 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:
apt-get install libqt4-sql-sqlite2 libqt4-sql
[edit] User Guide
- Select
- Favourites
- Matches
- Table
- News
- Update Score
Future versions of the User Guide might be written as Google Docs.
[edit] 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 documentation, tutorial and some 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.
A good source of images would probably be FutbolWallPapers.
Example:
background-image: url(/home/user/MyDocs/DCIM/20100501_001.jpg);
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.
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...
[edit] Release Plans
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:
- 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 (Previous) was downloaded 81 times. It was released on Thursday 6th May. The main changes were:
- 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.
- 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:
- 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.
- Predictions.
- 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)
- 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!.
[edit] 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.
- This page was last modified on 15 December 2011, at 06:25.
- This page has been accessed 51,863 times.