Line 1: |
Line 1: |
| + | '''New Page [[Features/New_ASLO]]''' |
| + | |
| The aslo2 is a hypothetical revision of the aslo site that brings new features. This pages discusses them. | | The aslo2 is a hypothetical revision of the aslo site that brings new features. This pages discusses them. |
| | | |
| You can find the code here: https://github.com/SAMdroid-apps/aslo/ | | You can find the code here: https://github.com/SAMdroid-apps/aslo/ |
| | | |
− | == JSON Backend == | + | You can view it live here: http://www.aslo.cf/ |
| + | |
| + | == Current ASLO Feature Parity == |
| + | |
| + | Here are the important things the current ASLO has that the new one has too: |
| + | |
| + | * Stores every version of the activity |
| + | * Shows the user the latest compatible version |
| + | * Can search by title or description |
| + | * Users can comment and add stars |
| + | * Activities in categories |
| + | * i18n ui |
| + | * The update manager in the system settings |
| + | |
| + | == New Features == |
| + | |
| + | === For Users === |
| + | |
| + | * Nicer ui - just in my own opinion |
| + | * No more reloads - the activities detail pages load almost instantly |
| + | * Localised search - users can search in their own language |
| + | * 'Instant' search - it is very fast :) |
| + | * A comment system that lets people to actually discuss activities - they can post ideas, questions, reviews and bug reports. Any user can then post a reply to the post and then somebody can reply to the reply......... |
| + | * '''Not yet implemented:''' Connect B.SL.O with the ASLO - Let people post bug reports is a really easy way |
| + | |
| + | === For Developers === |
| + | |
| + | * Github integration - a webhook can be connected with github which can build and update the activities listing automatically (see the technical description below) |
| + | * Communication with their users - they can talk over the comments system (in real time even). I really need to add email notifications so this can work better |
| + | * No more references to firefox addons in random corners of the site :) |
| + | |
| + | == Activity Categories == |
| + | |
| + | The new ASLO adds a ''categories'' field in the activity.info. It is a space separated list of categories. |
| + | |
| + | The current categories are (with their name for the activity.info): |
| + | |
| + | * Games (game) |
| + | * Programming (programming) |
| + | * Internet (internet) |
| + | * Science (science) |
| + | * Maths (maths) |
| + | * Geography (geography) |
| + | * Office (office) |
| + | * Tools (tools) |
| + | * System (system) |
| + | |
| + | Please tell me what you think about these. |
| + | |
| + | == Help Us --- Translate it! == |
| + | |
| + | '''Warning, the strings are unstable - you should wait before you translate''' |
| + | |
| + | Here it is, step by step: |
| + | |
| + | 1. Make a copy of this file: https://github.com/SAMdroid-apps/aslo/blob/master/web/locales/dev/translation.json |
| + | 2. Translate the values (the things on the right of the colons) |
| + | 3. Save the translated file in /web/locales/en_US/translation.json (replace en_US with your language) |
| + | 4. Also save it in the general language folder (without the country code). eg: /web/locales/en/translation.json |
| + | 5. Send me a pull request (or an email) |
| + | 6. BE HAPPY :) |
| + | |
| + | == Implementation Details == |
| + | |
| + | === JSON Backend === |
| | | |
| The data about the activities is stored in a json file. This json file is available via GitHub (currently https://github.com/SAMdroid-apps/sugar-activities). This is served with the correct content type here: http://aslo-bot-master.sugarlabs.org/data.json | | The data about the activities is stored in a json file. This json file is available via GitHub (currently https://github.com/SAMdroid-apps/sugar-activities). This is served with the correct content type here: http://aslo-bot-master.sugarlabs.org/data.json |
| | | |
− | == Activity Buildbots == | + | === Activity Buildbots === |
| | | |
| The aslo2 integrates a lot with GitHub. It offers a web hook for which the activity can be automatically built and listing data extracted. | | The aslo2 integrates a lot with GitHub. It offers a web hook for which the activity can be automatically built and listing data extracted. |
Line 25: |
Line 91: |
| * Authors - You need to do that manually | | * Authors - You need to do that manually |
| * Bundle - Automatically compiled by the robots | | * Bundle - Automatically compiled by the robots |
| + | * Categories - from the activity.info - a space seperated list under the name categories |
| | | |
| == Commenting == | | == Commenting == |
Line 33: |
Line 100: |
| * Replying to comments | | * Replying to comments |
| * 4 comment types: bug, question, idea and rating | | * 4 comment types: bug, question, idea and rating |
− |
| |
− | == Design / UX ==
| |
− |
| |
− | [[User:SAMdroid|SAMdroid]] ([[User talk:SAMdroid|talk]]) I think it looks nicer. You compare: http://imgur.com/C4oxFtS
| |
− |
| |
− | It is a html5 site with ajax, rather than just server side pages.
| |