Adds a feature to create a button on the right hand side of the toolbar at the end, right after the settings button.

On the other hand, the old add_toolbar_button function adds a button on the left half of the toolbar.

Author: srastanka

README.md

@@ -218,6 +218,7 @@ These methods return the DOM data itself
 - gmail.dom**.get_left_sidebar_links()**
 - gmail.dom**.search_bar()**
 - gmail.dom**.toolbar()**
+- gmail.dom**.right_toolbar()**
 - gmail.dom**.compose()** - compose dom object - receives the DOM element for the compose window and provides methods to interact
 - gmail.dom**.composes()** - retrives an array of `gmail.dom.compose` objects representing any open compose windows
 - [gmail.dom**.email()**](#gmaildomemailemail_el-or-email_id) - email dom object - receives an email DOM element or email id for an email currently being viewed. Abstracts interaction with that email.
@@ -246,6 +247,7 @@ These are some helper functions that the rest of the methods use. See source for
 - gmail.tools**.i18n(label)**
 - gmail.tools**.toggle_minimize()**
 - [gmail.tools**.add_toolbar_button(content_html, onclick_action, custom_style_class)**](#gmailtoolsadd_toolbar_buttoncontent_html-onclick_action-custom_style_class)
+- [gmail.tools**.add_right_toolbar_button(content_html, onclick_action, custom_style_class)**](#gmailtoolsadd_right_toolbar_buttoncontent_html-onclick_action-custom_style_class)
 - [gmail.tools**.add_compose_button(compose_ref, content_html, onclick_action, custom_style_class)**](#gmailtoolsadd_toolbar_buttoncompose_ref-content_html-onclick_action-custom_style_class)
 - [gmail.tools**.add_modal_window(title, content_html, onClickOk, onClickCancel, onClickClose)**](#gmailtoolsadd_modal_windowtitle-content_html-onClickOk-onClickCancel-onClickClose)
 - [gmail.tools**.remove_modal_window()**](#gmailtoolsremove_modal_window)
@@ -1265,6 +1267,16 @@ gmail.tools.add_toolbar_button('content_html', function() {
 }, 'Custom Style Classes');
 ```
 
+#### gmail.tools.add_right_toolbar_button(content_html, onclick_action, custom_style_class)
+
+Add a new button to Gmail Toolbar on the right hand side
+
+```js
+gmail.tools.add_right_toolbar_button('content_html', function() {
+  // Code here
+}, 'Custom Style Classes');
+```
+
 #### gmail.tools.add_compose_button(compose_ref, content_html, onclick_action, custom_style_class)
 
 Add button to compose window.

src/gmail.js

@@ -292,6 +292,15 @@ var Gmail_ = function(localJQuery) {
         return tb;
     };
 
+    api.dom.right_toolbar = function() {
+        var rtb = $(".Cr.aqJ");
+
+        while($(rtb).children().length === 1){
+            rtb = $(rtb).children().first();
+        }
+
+        return rtb;
+    };
 
     api.check.is_inside_email = function() {
         if(api.get.current_page() !== "email" && !api.check.is_preview_pane()) {
@@ -2293,6 +2302,34 @@ var Gmail_ = function(localJQuery) {
         return container;
     };
 
+    api.tools.add_right_toolbar_button = function(content_html, onClickFunction, styleClass) {
+        var container = $(document.createElement("div"));
+        container.attr("class","G-Ni J-J5-Ji");
+
+        var button = $(document.createElement("div"));
+        var buttonClasses = "T-I J-J5-Ji ash ";
+        if(styleClass !== undefined &&
+           styleClass !== null &&
+           styleClass !== ""){
+            buttonClasses += styleClass;
+        }else{
+            buttonClasses += "T-I-ax7 L3";
+        }
+        button.attr("class", buttonClasses);
+
+        button.html(content_html);
+        button.click(onClickFunction);
+
+        var content = $(document.createElement("div"));
+        content.attr("class","asa");
+
+        container.html(button);
+
+        api.dom.right_toolbar().append(container);
+
+        return container;
+    };
+
     api.tools.add_compose_button =  function(composeWindow, content_html, onClickFunction, styleClass) {
         var button = $(document.createElement("div"));
         var buttonClasses = "T-I J-J5-Ji aoO L3 ";