General Improvements & Additions (#303)

* Update access_controls.md

* Update messages.md

* Update messages.md

* Update outbound_routes.md

* Update menu_manager.md

* Update menu_manager.md

source/advanced/access_controls.md

@@ -14,9 +14,7 @@ calls not working between extensions and other undesirable results.
 :::{improtant}   
 Make sure you keep the **providers** access control (formerly known as   
 "domains") as default "**deny**".   
-
 Do not put your public ip or phone IP addresses in the domains access control list.   
-
 Avoid putting both the domain and cidr on the same node.   
 :::   
 

source/advanced/menu_manager.md

@@ -4,4 +4,23 @@ Used to customize one or more menus.
 
 ![image](../_static/images/advanced/menu_manager/fusionpbx_menu_manager1.png)
 
+:::(note)   
+Make sure you mark any customized menu items as protected. Running App Defaults    
+on the upgrade page, all unprotected items will be reset to their default values.   
+:::   
+
 ![image](../_static/images/advanced/menu_manager/fusionpbx_menu_manager2.png)
+
+## Menu Icons
+
+You can change the menu icon by first selecting the menu item you wish to customize,   
+in this example we'll be changing the **Applications** icon.
+
+![image](../_static/images/advanced/menu_manager/fusionpbx_menu_manager4.png)
+
+You will see a setting for **Icon** and **Icon color**. You can then open the dropdown   
+list or select the icon on the right to open the grid list.
+
+![image](../_static/images/advanced/menu_manager/fusionpbx_menu_manager5.png)
+
+Once you've made a selcection, hit save and reload.

source/applications/messages.md

@@ -1,32 +1,34 @@
 # Messages
 
-Send and receive SMS and MMS messages. This tool utilizes a service
-called, message_queue to send and receive messages. It relays
-SMS messages to registered endpoints including softphones and desk
-phones that support message_queue. This feature does support
-multiple Providers simultaneously.
+Send and receive SMS and MMS messages. This tool utilizes a service   
+called, message_queue to send and receive messages. 
 
-### Install
+It relays SMS messages to registered endpoints including softphones and desk   
+phones that support message_queue. 
 
+This feature supports multiple Providers simultaneously.   
 
+## Install
+
+```
     cd /var/www/fusionpbx/app
     git clone https://github.com/fusionpbx/fusionpbx-app-messages.git messages
     git clone https://github.com/fusionpbx/fusionpbx-app-providers.git providers
     php /var/www/fusionpbx/core/upgrade/upgrade.php
+```
 
 <br>
 
--   **App Defaults** After getting the source code run Upgrade -\> App
-    Defaults
--   **Upgrade Schema** Next run Advanced -\> Upgrade -\> Schema
-    (checked) then press Execute
--   **Permissions** From Advanced -\> Upgrade -\> Permission Defaults
-    (checked) then press Execute
--   **Menu** From Advanced -\> Upgrade -\> Menu Defaults (checked) then
-    press Execute
+Navigate to **Advanced** > **Upgrade** and run the following:
 
-### Menu
+-   App Defaults
+-   Schema
+-   Group Permissions
+-   Menu Defaults
 
+## Menu
+
+```
     If you used restore menu defaults you can skip this step.
     Providers
         Title: Providers
@@ -38,20 +40,25 @@ multiple Providers simultaneously.
         Link: /app/messages/messages.php
         Parent Menu: Applications
         Groups: superadmin
+```
 
 <br>
 
+```
     cp /var/www/fusionpbx/app/messages/resources/service/debian-message_queue.service /etc/systemd/system/message_queue.service
     systemctl enable message_queue
     systemctl start message_queue
     systemctl daemon-reload
+```
 
 <br>
 
+```
     cp /var/www/fusionpbx/app/messages/resources/service/debian-message_events.service /etc/systemd/system/message_events.service
     systemctl enable message_events
     systemctl start message_events
     systemctl daemon-reload
+```
 
 <br>
 
@@ -62,8 +69,8 @@ multiple Providers simultaneously.
 ```
 <br>
 
--   Add the message media rewrite below inside the server 443 section.
-    Add it just below the REST API rewrite rule or just above the phone
+-   Add the message media rewrite below inside the server 443 section.   
+    Add it just below the REST API rewrite rule or just above the phone   
     vendor rewrite rules.
 
 
@@ -72,6 +79,7 @@ server {
 
    listen 443;
 ```
+
 <br>
 
 -   Rewrite rule
@@ -80,6 +88,7 @@ server {
     #message media
     rewrite "^/app/messages/media/(.*)/(.*)" /app/messages/message_media.php?id=$1&action=download last;
 ```
+
 <br>
 
 - Then restart nginx
@@ -87,39 +96,52 @@ server {
 ```
     service nginx restart
 ```
+
 <br>
 
-### Setup
-
--   Go to Menu Accounts -\> Providers.
--   Press the **ADD** button and find your provider and then press the
-    **SETUP** button. After adding your provider will need to get Add
-    your API key authorization to the settings that were added for your
-    SMS provider.
--   If your provider is not listed then you will need access to your
-    Providers SMS API documentation and would need to compare with the
-    other providers. When you are ready to add your provider press **Add
-    a Provider** for a template to start from. You may need support to
-    get through this step if you need to add your own VoIP provider. If
-    you are observant and like to use your brain you do have a chance at
-    working through this and get it working.
-
-**Destinations -\> Inbound** \* Assign the destination to a user or
-group. \* In Dialplan -\> Destinations make sure the number you have
-enabled for SMS is assigned to a user account and to a provider using
-the select list in inbound destinations. \* Make sure to set the Country
-Code. This helps to match the SMS destination number with an inbound
-destination. It makes it possible to the number without the country
-code, with the country code and e.164.
-
-**Extensions** \* In Accounts -\> Extensions make sure the user is
-assigned to an extension.
-
-**Mobile** \* On your mobile phone send an SMS or MMS message to the
-number you set up for SMS with the provider.
-
-**Messages** \* Application -\> Messages from here you can use the New
-Messages button to send an SMS or MMS message.
-
-**Providers** \* The providers are identified and allowed to use IP
-authentication.
+## Setup
+
+-   Go to **Accounts** > **Providers**.
+-   Press the **ADD** button and find your provider and then press the   
+    **SETUP** button. After adding your provider will need to get Add   
+    your API key authorization to the settings that were added for your   
+    SMS provider.   
+    
+-   If your provider is not listed then you will need access to your   
+    Providers SMS API documentation and would need to compare with the   
+    other providers.   
+    
+-   When you're ready to add your provider press **Add Provider** for a   
+    template to start from. You may need support for this step if you plan   
+    to add your own VoIP provider.   
+
+-   Destinations** > **Inbound**: Assign the destination to a user or   
+    group. In **Dialplan** > **Destinations** make sure the number you have   
+    enabled for SMS is assigned to a user account and to a provider using   
+    the select list in inbound destinations.   
+       
+-   Make sure to set the Country Code.
+
+-   This helps to match the SMS destination number with an inbound   
+    destination. It makes it possible to the number without the country   
+    code, with the country code and e.164.   
+
+### Extensions
+
+-    In **Accounts** > **Extensions** make sure the user is   
+     assigned to an extension.   
+
+### Mobile
+
+-    On your mobile phone send an SMS or MMS message to the   
+     number you set up for SMS with the provider.   
+
+### Messages
+
+-    In **Application** > **Messages** you can use the **New   
+     Messages** button to send an SMS or MMS message.   
+
+### Providers
+
+-    The providers are identified and allowed to use IP   
+     authentication.   

source/dialplan/outbound_routes.md

@@ -11,13 +11,12 @@ youtube video](https://youtu.be/rhyfCKLBI-Y).
 **Configuring an Outbound Route.**
 
 -   Select **Dialplan** from the drop-down list and then click
-    **Outbound Routes** .
+    **Outbound Routes**.
 -   Click the **plus** button on the right. Enter the route information
     below and Click **Save** once entry is complete.
 
 ![image](../_static/images/dialplan/fusionpbx_outbound_routes1.png)
 
-
 ![image](../_static/images/dialplan/fusionpbx_outbound_routes2.png)
 
 ```
@@ -33,43 +32,45 @@ FusionPBX. Thank you for your support!**
 
 ### Pin Numbers
 
-To have the system ask for a PIN number before a call is made. A good
-use is if you don\'t want every user on the system to be able to call
-international destinations. This can be done with a single PIN or
-multiple PINs by using the \"PIN Number APP\".
+Have the system ask for a PIN number before a call is made. A good use is   
+if you don't want every user on the system to call international destinations. 
+
+This can be done with a single PIN or multiple PINs by using the "PIN Number APP".
 
 #### **To use a single PIN number for all calls**
 
 Before the bridge action on the outbound route add the following actions
 
+```
     action set pin_number=(Whatever pin number you choose)
     action lua pin_number.lua
+```
 
 #### **To use the PIN Number App to manage multiple PINs**
 
--   First enable access to the **\"PIN Number\"** app by giving
+-   First enable access to the **"PIN Number"** app by giving
     permissions to the group of users you want to have access in
-    **Advanced \> Group Manager**. Make sure the **\"PIN Number\"** App
+    **Advanced** > **Group Manager**. Make sure the **"PIN Number"** App
     is displayed in the menu by selecting the groups that can view it in
-    **Advanced \> Menu Manager**.
--   Set the PINs you would like to use in **Apps \> PIN Numbers**
+    **Advanced** > **Menu Manager**.
+-   Set the PINs you would like to use in **Apps** > **PIN Numbers**
 
 Before the bridge action on the outbound route add the following actions
 
+```
     action set pin_number=database
     action lua pin_number.lua
+```
 
 #### Which gateway is my call using?
 
 If you want to know the gateway your call is using there is currently no
-way to do this with FusionPBX\'s GUI. Instead you can do it this way.
+way to do this with FusionPBX's GUI. Instead you can do it this way.
 
--   Go to **Advanced -\> Command** and in the **switch** command
+-   Go to **Advanced** > **Command** and in the **switch** command
     dropdown section type
 
-<!-- -->
-
-    show channels as xml and then press the execute button.
+-   show channels as xml and then press the execute button.
 
 -   In the output that is returned, look for the string **sofia/gateway/
     and the gateway name.** This is the gateway your call is using.