FusionPBX for ex-Trixbox users

This blog is intended to be read in sequential order as it is a series of steps that I followed to build a fully functioning fusionpbx phone system. However you might just need to find out how to do a particular thing so you might want to use the search box below to find that specific step. Please give feedback - if you know a better way to do something share it!

Wednesday, September 15

Understanding dial plans in more depth

Since writing my earlier posts about dial plans, I've discussed them with people and learnt a bit more about them so I'm sharing that with you to make your life easier as well!

The default dialplan that ships with freeswitch gives you 1000-1019 and 2000-2999 for use for extensions and uses lots of other numbers for other purposes.  When FusionPBX was created it was decided to move all these pre-defined things that were in the freeswitch default configuration out of the way so that people were unrestricted in what extension numbers they could use.

Accordingly all the default freeswitch dialplan configurations have been moved to start with *.  You can see these in dialplan/default.xml.  The easiest way to look at this is to go to the Dialplan Manager screen and press the Advanced button.  This will open up an editor that shows you this particular file and allows you to change it.

All the dial plan entries you create in FusionPBX are stored in the database and the database is used to automatically generate the dialplan files located in default/*.xml.  So if you have a look through the default dialplan you will see this line halfway down the file:
X-PRE-PROCESS cmd="include" data="default/*.xml"

Everything in the default dialplan BEFORE this line is processed before your dialplan entries and therefore will override anything in your default dialplan.  Anything in the default dialplan AFTER this line is processed after your dialplan entries and therefore will be overridden by anything in your default dialplan.

Additionally, you can, if you want, modify this default dialplan directly in the editor.  Anything you see in the default dialplan is only defined there, it isn't stored in the fusionPBX database.

I hope that removes some of the pain of understanding dialplans!

No comments:

Post a Comment