Add custom actions to notifications

[gotev]

It will be useful to be able to add custom actions to UploadNotificationConfig, like this:

new UploadNotificationConfig()
    .addAction(actionIconResourceID, buttonText, pendingIntent)

addAction should have the following signature:

public final UploadNotificationConfig addAction(
    int iconResourceID, String text, PendingIntent action)

This explains how to marshal and unmarshal PendingIntents to/from Parcelable

[gotev]

@hendrawd if you need help with the implementation, let me know here

[hendrawd]

It's ok for marshal and un-marshal PendingIntent, but i think it is better if we can add more than 1 actions there, so i work on List instead of just 1 PendingIntent. I have tried with more than 1 action, and 3 is the best(visible). What do you think?

[gotev]

@hendrawd Yes. When addAction is invoked, a new element has to be added to the underlying list. We can log a warning message if the upload notification config has more than three buttons

[mnaswin3]

Hi guys,
any update on this feature?

[gotev]

@mnaswin3 not yet, but you can send a PR!

[gotev]

Implemented actions for notifications. Major refactor to UploadNotificationConfig class was needed, to have a better structure, less method count (#248) and easier code readability. It drops retro-compatibility, but for the better. Updated demo app. This feature will be available starting from release 3.3.

Read the code example below, which is taken from the demo app's BaseActivity, in which I have implemented an example of how you can cancel an upload from an action.

Before 3.3:

protected UploadNotificationConfig getNotificationConfig(@StringRes int title) {
    return new UploadNotificationConfig()
            .setIcon(R.drawable.ic_upload)
            .setCompletedIcon(R.drawable.ic_upload_success)
            .setErrorIcon(R.drawable.ic_upload_error)
            .setCancelledIcon(R.drawable.ic_cancelled)
            .setIconColor(Color.BLUE)
            .setCompletedIconColor(Color.GREEN)
            .setErrorIconColor(Color.RED)
            .setCancelledIconColor(Color.YELLOW)
            .setTitle(getString(title))
            .setInProgressMessage(getString(R.string.uploading))
            .setCompletedMessage(getString(R.string.upload_success))
            .setErrorMessage(getString(R.string.upload_error))
            .setCancelledMessage(getString(R.string.upload_cancelled))
            .setClickIntent(new Intent(this, MainActivity.class))
            .setClearOnAction(true)
            .setRingToneEnabled(true);
}

In 3.3:

protected UploadNotificationConfig getNotificationConfig(String uploadId, 
                                                         @StringRes int title){
    UploadNotificationConfig config = new UploadNotificationConfig();

    PendingIntent clickIntent = PendingIntent.getActivity(
            this, 1, new Intent(this, MainActivity.class),
            PendingIntent.FLAG_UPDATE_CURRENT);

    config.setTitleForAllStatuses(getString(title))
            .setRingToneEnabled(true)
            .setClickIntentForAllStatuses(clickIntent)
            .setClearOnActionForAllStatuses(true);

    config.getProgress().message = getString(R.string.uploading);
    config.getProgress().iconResourceID = R.drawable.ic_upload;
    config.getProgress().iconColorResourceID = Color.BLUE;
    
    // this is how you add an action to a specific notification status
    config.getProgress().actions.add(new UploadNotificationAction(
            R.drawable.ic_cancelled,
            getString(R.string.cancel_upload),
            NotificationActions.getCancelUploadAction(this, 1, uploadId)));

    config.getCompleted().message = getString(R.string.upload_success);
    config.getCompleted().iconResourceID = R.drawable.ic_upload_success;
    config.getCompleted().iconColorResourceID = Color.GREEN;

    config.getError().message = getString(R.string.upload_error);
    config.getError().iconResourceID = R.drawable.ic_upload_error;
    config.getError().iconColorResourceID = Color.RED;

    config.getCancelled().message = getString(R.string.upload_cancelled);
    config.getCancelled().iconResourceID = R.drawable.ic_cancelled;
    config.getCancelled().iconColorResourceID = Color.YELLOW;

    return config;
}

It's more verbose now, but you can finely tune every aspect of every notification, in a way which was not possible before (#293), and it's easier to read. Check out the new utility functions in UploadNotificationConfig which lets you set properties globally for all the notification statuses.