Git Product home page Git Product logo

apptour's Introduction

AppTour

Show your apps key features in a cool way.

About

Show to your users the purpose and the key functions of your app in a cool material way using the AppTour library.

Screenshot

img

Features

  • Pre made slides.
  • Add your own custom slides.
  • Next, Skip and Done buttons.

Usage

Create a new Activity that extends from the AppTour and then in the init add the slides and configure the intro.

Important: Don't override the onCreate method. Use init.

public class MainActivity extends AppTour {

    @Override
    public void init(Bundle savedInstanceState) {

        int firstColor = Color.parseColor("#0097A7");
        int secondColor = Color.parseColor("#FFA000");
        int customSlideColor = Color.parseColor("#009866");

        //Create pre-created fragments
        Fragment firstSlide = MaterialSlide.newInstance(R.drawable.cybr, "Presentations on the go",
                "Get stuff done with or without an internet connection.", Color.WHITE, Color.WHITE);

        Fragment secondSlide = MaterialSlide.newInstance(R.drawable.cybr, "Share and edit together",
                "Write on your own or invite more people to contribute.", Color.WHITE, Color.WHITE);

        //Add slides
        addSlide(firstSlide, firstColor);
        addSlide(secondSlide, secondColor);

        //Custom slide
        addSlide(new CustomSlide(), customSlideColor);

        //Customize tour
        setSkipButtonTextColor(Color.WHITE);
        setNextButtonColorToWhite();
        setDoneButtonTextColor(Color.WHITE);
    }

    @Override
    public void onSkipPressed() {
        //Do something after clicking Skip button.
    }

    @Override
    public void onDonePressed() {
        //Do something after clicking Done button.
    }
}

Get It

allprojects {
        repositories {
            jcenter()
        }
    }

    dependencies {
        compile 'com.vlonjatg.android:app-tour:1.0'
    }

Customization

//Set String value of the Skip button
setSkipText("Skip");

//Set String value of the Done button
setDoneText("Done");

//Set the text color of the skip button
setSkipButtonTextColor(Color.WHITE);

//Set the next button color to white
setNextButtonColorToWhite();

//Set the next button color to black
setNextButtonColorToBlack();

//Set the text color of the done button
setDoneButtonTextColor(Color.WHITE);

//Set the color of the separator between slide content and bottom controls
setSeparatorColor(Color.WHITE);

//Set the color of the active dot indicator
setActiveDotColor(Color.RED);

//Set the color of the inactive dot indicator
setInactiveDocsColor(Color.GRAY);

//Show the skip button
showSkip();

//Hide the skip button
hideSkip();

//Show the next button
showNext();

//Hide the next button
hideNext();

//Show the done button
showDone();

//Hide the done button
hideDone();

//Show indicator dots
showIndicatorDots();

//Hide indicator dots
hideIndicatorDots();

Example

An example is available.

Developed By

Vlonjat Gashi - Twitter

Attributes

This library is inspired by AppIntro library.

License

AppTour is available under the MIT licence.

The MIT License (MIT)

Copyright (c) 2015 Vlonjat Gashi

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.