# Commit plugin

If [editable on the platform](https://docs.flightwatching.com/user-manual/general-conf/configuration/plugins#add-plugin) - commit in order to save the changes in the Version Controlled System.

In order to commit plugin(s), the good practice is to check what was changed on the server. The first thing to do is to click on the button CHECK UPGRADES (the button changes into CHECK IN PROGRESS) and wait until the check is finished:

<div><figure><img src="https://4203901285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LucrvGdSn3RONbIcfqh%2Fuploads%2FWnG7DmxSsIlCaZUlHkX1%2FScreenshot%202024-01-29%20at%2015.19.11.png?alt=media&#x26;token=f9109734-99d5-47ce-8aa7-e4d2d40d5c05" alt=""><figcaption><p>CHECK IN PROGRESS</p></figcaption></figure> <figure><img src="https://4203901285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LucrvGdSn3RONbIcfqh%2Fuploads%2FLZHwgafYglKUpEPvZ2Kg%2FScreenshot%202024-01-29%20at%2015.19.30.png?alt=media&#x26;token=d98791f9-6461-457f-8550-3b7e464b5d0a" alt=""><figcaption><p>CHECK FINISHED</p></figcaption></figure></div>

{% hint style="info" %}
NOTE: The plugins that can be committed on the platform are the ones that are *editable* on the platform (no lock icon) and that have the *icon* beside its name - *locally edited*.&#x20;
{% endhint %}

For example, the plugin *fw\.a320 below* does not have the lock icon, but it does the icon for locally edited:

<figure><img src="https://4203901285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LucrvGdSn3RONbIcfqh%2Fuploads%2FTJyboOARp7zN7Uqyt5bm%2FScreenshot%202024-01-29%20at%2015.32.14.png?alt=media&#x26;token=f6da4249-0cff-4786-8d70-9a3a5296b159" alt=""><figcaption></figcaption></figure>

Click on *DET* button situated on the right side of the line to enter to the details of that plugins:

<figure><img src="https://4203901285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LucrvGdSn3RONbIcfqh%2Fuploads%2FAMvBHmSNivKNA4vrchU9%2FScreenshot%202024-01-29%20at%2015.56.37.png?alt=media&#x26;token=4573badc-f8d0-4fae-aa0f-b4d2fc8ba0fb" alt="" width="375"><figcaption></figcaption></figure>

The details of the plugin was explained previously - [here](https://docs.flightwatching.com/user-manual/admin-user-manual/edit-plugins/..#details-of-plugin). The display of the plugin that is locally edited changes from the 'up-to-date' plugin though (see image above). Here, the new button shows up at the header: ***COMMIT*** and the buttons ***Filter only local changes*** next to some of the elements.

When clicking on ***Filter only local changes***, the parts of that element will open and show only what was locally modified. For example, clicking on the ***Filter only local changes*** button beside the *10 dashboards* will open dashboards elements:

<figure><img src="https://4203901285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LucrvGdSn3RONbIcfqh%2Fuploads%2FJ02nBfnf7SMPuZus8s9U%2FScreenshot%202024-01-30%20at%2009.16.27.png?alt=media&#x26;token=06c3b26b-b5a6-4635-b894-3925f85f2937" alt="" width="375"><figcaption></figcaption></figure>

To see exactly what was changed click on the ***MODIFY*** button located on the right side of the element:

<figure><img src="https://4203901285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LucrvGdSn3RONbIcfqh%2Fuploads%2FFrdUNUMroK9x1kNOoGAx%2FScreenshot%202024-01-30%20at%2009.19.10.png?alt=media&#x26;token=b53b7af7-6356-4693-8930-e1fbe6ce8744" alt="" width="375"><figcaption><p>MODIFY - differences between ref and local</p></figcaption></figure>

In that example, only modification was the name of the dashboard.

Once you have confirmed all the modifications are correct and could be saved to the VCS and could become the new reference, click on ***COMMIT*** button. It will publish the local changes as the new reference. After clicking ***COMMIT*** button, the little window pops up where you **need to** input the reason of commit (that will save that information to the logs):

<div><figure><img src="https://4203901285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LucrvGdSn3RONbIcfqh%2Fuploads%2Fwn8JmSpf5qlcOXKUOIXp%2FScreenshot%202024-01-30%20at%2009.22.15.png?alt=media&#x26;token=9d576220-5d02-47a3-83b3-53244026a649" alt="" width="133"><figcaption></figcaption></figure> <figure><img src="https://4203901285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LucrvGdSn3RONbIcfqh%2Fuploads%2FFhurdRvsOAKTCDW1HuCU%2FScreenshot%202024-01-30%20at%2009.24.09.png?alt=media&#x26;token=9287abaf-7458-40b1-888f-f1054adac753" alt="" width="375"><figcaption><p>commit reason</p></figcaption></figure></div>

&#x20;After clicking on ***OK*** button below the reason of commit, the plugin will start the process of publishing the local changes. The light blue banner shows up with the information: "*INFO: plugin fw\.a320 is being committed. Wait for completion*":

<figure><img src="https://4203901285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LucrvGdSn3RONbIcfqh%2Fuploads%2F9QzdCYs6d6emcvGm6RzB%2FScreenshot%202024-01-30%20at%2009.32.07.png?alt=media&#x26;token=ac73bab9-0693-4573-86b2-04403b4560d4" alt="" width="563"><figcaption><p>plugin is being committed</p></figcaption></figure>

Once the plugin is all set, the banner  changes and shows information about the version control with SHA code:

<figure><img src="https://4203901285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LucrvGdSn3RONbIcfqh%2Fuploads%2Ff69BH75SPs0i1l2xR7sm%2FScreenshot%202024-01-30%20at%2009.36.07.png?alt=media&#x26;token=1fc270e5-063a-4c93-87b1-6988668267e9" alt="" width="563"><figcaption></figcaption></figure>

The page auto-refresh after that, and the newly committed plugin is 'clear' from the local modifications:

<figure><img src="https://4203901285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LucrvGdSn3RONbIcfqh%2Fuploads%2Frl1wyrVhxIMMGGJZoBK7%2FScreenshot%202024-01-30%20at%2009.38.37.png?alt=media&#x26;token=404f1b5c-1718-4fdf-9171-a8f580030267" alt="" width="563"><figcaption><p>plugin committed</p></figcaption></figure>

Let's now [deploy that plugin](https://docs.flightwatching.com/user-manual/admin-user-manual/edit-plugins/deploy-plugin) on another server.
