The growth Android Developer's best friend
PHP CSS JavaScript ApacheConf
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
api
htdocs
myapp
templates
.gitignore
.gitmodules
README.md
db.sql
update.php
update_one.php

README.md

AndroidReviews

Install the Website

Requirements

  • An Apache server. Minimum efforts would be made to port the .htaccess and provide compatibilty with other webservers.
  • PHP 5.3+ with curl and mysql support
  • MySQL
  • lessc (installed from packages or npm)

Manual installation required

Get the website!

Clone or download it from GitHub. Move to the directory you just created with the sources cd AndroidReviews

Install TinyMVC
  1. Go to the offical website to download the latest version.
  2. Extract the tinymvc folder only (you don't need the rest).
  • If you plan to use TinyMVC for another project, put it in a global location.
  • If you don't, you can just put it in the same directory (AndroidReviews)
Create and edit the index.php file
cp templates/index.php.template htdocs/index.php
$EDITOR htdocs/index.php
  1. Replace PATH_TO_TinyMVC_GLOBAL_FILES with the path of the tinymvc folder you previously installed (depends if you decided to use a global location or keep it with the rest of this website)
  2. Replace PATH_TO_THIS_REPO_ROOT with the path of the website (probably AndroidReviews)
Install the database
# CREATE DATABASE androidreviews
mysql androidreviews < db.sql
Edit the configuration of the database
cp templates/config_database.php.template myapp/configs/config_database.php
$EDITOR myapp/configs/config_database.php
Install the API consumer
wget https://raw.github.com/db0company/generic-api/master/consumer/php/consumer.php -O myapp/plugins/consumer.php
In production? Compile the CSS file
lessc --yui-compress htdocs/less/androidreviews.less > htdocs/css/androidreviews.min.css

Edit the header to comment or remove the 2 lines about less files and uncomment the css line.

Configure your webserver

Your domain should point on the htdocs folder. You should have allowed url rewriting.

Install the API

You may install it on the same server, but the goal of this API is to serve several countries by having APIs installed in several different countries that communicate with the Android Market.

Requirements

  • A web server (ex: Apache)
  • PHP 5.3+ with curl support
  • The submodule generic-api, should be cloned automatically with the website

Manual installation required

Stay in the main folder `AndroidReviews'.

Create some folders
mkdir -p api/icons/
Edit the configuration
cp templates/conf.php.template api/conf.php
$EDITOR api/conf.php
Install the unofficial Android Market API:
wget https://github.com/splitfeed/android-market-api-php/archive/master.zip
unzip master.zip
mv android-market-api-php-master/ api/android-market-api-php
rm master.zip
Configure your webserver

Your domain should point on the api folder. It should start with country.api.yourdomain where country is the country code where your server is hosted (us or fr or instance). You should also point a sub domain files.country.api.yourdomain to the api/icons folder.

If you use apache, put this .htaccess file in /api

Options +FollowSymlinks
Options +Indexes
RewriteEngine on

RewriteCond %{SCRIPT_FILENAME} !-d
RewriteCond %{SCRIPT_FILENAME} !-f
RewriteRule   ^([a-zA-Z0-9_\-]+)/([a-zA-Z0-9_\-/]+)$   api.php?resource=$1&id=$2 [QSA]
RewriteRule   ^([a-zA-Z0-9_\-]+)/*$   api.php?resource=$1 [QSA]

If you use nginx add this redirection rule:

rewrite ^/([a-zA-Z0-9_-]+)/*$ /api.php?resource=$1;

Add new countries

You may install as much countries you'd like by installing the API (only, not the website) on different servers in different countries. Those countries should be added in the website configuration file. A picture of the flag of the coutry should also be added in the website's folder htdocs/img/countries.