Night Club Application Template is a native Android application that provides you an easy way to create a presentation application of your club/night club. It doesn't require programming knowledge; all you have to do is to edit some configuration files.

The users will get the latest news about your club with the help of Facebook and Soundcloud integration.

The application has 6 sections:

1. About section – provides general information
2. Events – presents user defined events as well as Facebook events from the club’s page
3. Gallery – shows user defined albums and pictures as well as Facebook fetched albums with the correspondent pictures
4. Music – this section fetches your tracks from Soundcloud and gives the user the possibility to listen to your published tracks
5. Map – interactive map for better localizing your venue
6. Social – all other social pages are shown here for better interaction with the user (Facebook, Youtube, Twitter, etc.)

Import the NightClub and library projects into your favorite IDE.

Add the library project as a library to the NightClub project: right click on NightClub project -> properties -> Android -> Add ... -> select library

Try building and deploying the project on the emulator or own device. If it has no errors you can configure it.

Importing the project (video) http://dl.dropbox.com/u/32238246/nightappvid.mp4

In order to populate the application with your own data, you don't need any programming skills at all. All you have to do is to edit some configuration files. The following sections will describe how to do this plain and simple.

Note: all the configuration fields are mandatory!

The general configuration file will be found in /res/values/strings.xml. Here we have the following items that can be configured:

• night_club_name – the name of the venue

• about_content – the content that will be displayed in the about section

• night_club_events_mail – on the user defined events, when a user wants to join the event, an email will be sent to this address

• night_club_email – the general email of the venue

• night_club_tel – the telephone number of the venue (the user has the possibility to call this phone from the application)

• night_club_web – the website of the venue

• night_club_address – the address of the venue

• night_club_latitude – the latitude coordinate of the venue (used for map localization)

• night_club_longitude – the longitude coordinate of the venue (used for map localization)

The file that defines your Facebook and Soundcloud feed accounts is located in /src/com/chupamobile/android/nightclub/utils/APIHelper.java. Here you must define the following fields:

• FACEBOOK_PAGE_ID – the Facebook page of the venue
• SOUNDCLOUD_USERNAME – your Sounclooud username

You can define your own feeds besides those fetched from Facebook. The configuration files for the user defined feeds are in /res/raw/ folder.

Events feed

For the events feed edit the events.xml file:

<events>
    <event>
        <thumb>event1.jpg</thumb>
        <title>First Event</title>
        <start_date>2012-JUL-15 20:00</start_date>
        <end_date>2012-JUL-15 23:00</end_date>
        <description>Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua Ut enim ad minim veniam, quis nostrud  exercitation ullamco laboris nisi ut aliquip  ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</description>
        <link>http://nightclub-app.com/events/1</link>
    </event>
</events>

For every event add a new <event> tag. Under this tag configure the following:

• <thumb> : the name of the thumbnail that will be displayed along with the event

• <title> : the name of the event

• <start_date> : the start date of the event

• <end_date> : the end date of the event

• <description> : the description of the event

• <link> : a website link to the event

Gallery feed

For the gallery feed please configure the gallery.xml file: Album1 album1cover.jpg album1img1.jpg album1img2.jpg album1img3.jpg

    <album>
        <name>Album2</name>
        <album_cover>album2_cover.jpg</album_cover>
        <image>album2_img1.jpg</image>
        <image>album2_img2.jpg</image>
    </album>
</gallery>

The gallery has a collection of albums that contain images. For every album under the <album> tag please configure the following:

• <name> : the name of the album

• <album_cover> : the album cover thumbnail that will appear in the section

• <image> : an image of the album

You can specify as many images as you want.

Social feed

The Social feed will appear in the Social section. The configurable file is the social.xml:

<social>
    <item>
        <name>Facebook</name>
        <link>https://www.facebook.com/Chupamobile</link>
    </item>

    <item>
        <name>Youtube</name>
        <link>http://www.youtube.com/user/ChupaMobile</link>
    </item>

    <item>
        <name>Twitter</name>
        <link>https://twitter.com/chupamobile</link>
    </item>
</social>

Here, under each <item> tag you must define the following:

• <name> : the name of the social feed

• <link> : the link to the social feed

Attention: All the images from the User defined feed must be placed into /assets folder!!

Additional configuration can be done:

• splash screen image – overwrite your own splashscreen image to the /res/drawable-hdpi/splash_screen.png

• about section image – overwrite your own about image to the /res/drawable-hdpi/about_img.png

Attention: In order the Map section to display the map you must supply a correct Map API Key in the /res/layout/screen_map.xml file:

<com.google.android.maps.MapView
        xmlns:android="http://schemas.android.com/apk/res/android"
        android:id="@+id/mapview"
        android:layout_width="fill_parent"
        android:layout_height="220dp"
        android:apiKey="**0lhSNOa5yyfy8EtxbFZZVOyydthOaPr21MJWUFA**"
        android:clickable="true" />

In order to obtain a valid key, please follow the steps presented here: https://developers.google.com/maps/documentation/android/mapkey.

This very simple to configure, yet extremely powerful application will engage your clients more and more in your social activities and promote your venue.

The project uses Jake Wharton's View Pager Indicator library : http://viewpagerindicator.com/