65 lines
2.4 KiB
Markdown
65 lines
2.4 KiB
Markdown
|
# The FreeSWITCH Portal Project
|
||
|
|
|
||
|
|
The FreeSWITCH Portal Project is designed to show an intuitive view of the FreeSWITCH internals.
|
||
|
|
|
||
|
|
It can be used by FreeSWITCH funs, administrators, developers etc.
|
||
|
|
|
||
|
|
It does not aims to replace GUIs such as fusionPBX or blue.box.
|
||
|
|
|
||
|
|
It would be very easy to use and super helpful for new FreeSWITCH users.
|
||
|
|
|
||
|
|
## Philosophy
|
||
|
|
|
||
|
|
To provide a GUI out of the box without depends on external resources like PHP or a webserver such as Apache or Nginx.
|
||
|
|
|
||
|
|
Mainly developed with static html and Javascripts, and perhaps some lua scripts can help do some more magic things later.
|
||
|
|
|
||
|
|
## Install
|
||
|
|
|
||
|
|
Assume you installed FreeSWITCH in the default place - /usr/local/freeswitch, you can do
|
||
|
|
|
||
|
|
cd /usr/local/freeswitch/htdocs
|
||
|
|
git clone https://github.com/seven1240/FreeSWITCH-Portal.git portal
|
||
|
|
|
||
|
|
In FreeSWITCH you need to
|
||
|
|
|
||
|
|
load mod_xml_rpc
|
||
|
|
|
||
|
|
Open your browser (Only Chrome is tested) and go to
|
||
|
|
|
||
|
|
http://localhost:8080/portal/index.html
|
||
|
|
|
||
|
|
If you it asking for username and password you can find them in /usr/local/freeswitch/conf/autoload_configs/xml\_rpc.conf.xml. For more information see <http://wiki.freeswitch.org/wiki/Mod_xml_rpc> .
|
||
|
|
|
||
|
|
## Todo
|
||
|
|
|
||
|
|
* Websocket: by add websocket support in FreeSWITCH we can see channel changes lively, I have some working code as a patch to mod\_event\_socket.
|
||
|
|
|
||
|
|
* Modify users: A raw idea to add a new user would be something like below and reloadxml.
|
||
|
|
|
||
|
|
sed -e 's/1000/new-user/g' 1000.xml > new-user.xml
|
||
|
|
|
||
|
|
* Modify dialplan and/or other XMLs: possible to use some online XML editor and can save the XML with some lua or C code at the backend, although there are security concerns.
|
||
|
|
|
||
|
|
* Store information in DB: I guess the Dbh handle in lua should can do something like this.
|
||
|
|
|
||
|
|
* Web terminal: With terminal.js like things and websocket we can really build a web version of fs_cli
|
||
|
|
|
||
|
|
* rtmp web client support to make and receive calls
|
||
|
|
|
||
|
|
* WebRTC?
|
||
|
|
|
||
|
|
* Logging, Event Debugging or SIP tracing: Yeah, more magic
|
||
|
|
|
||
|
|
* i18n
|
||
|
|
|
||
|
|
## Security
|
||
|
|
|
||
|
|
The primary goal is to help new users learn and use FreeSWITCH. Please DON'T put this on your production server as I haven't think anything about security.
|
||
|
|
|
||
|
|
## Development
|
||
|
|
|
||
|
|
I started this project to learn how to use [bootstrap](twitter.github.com/bootstrap/index.html) and [ember.js](twitter.github.com/bootstrap/index.html), the latter said it is a framework for creating **ambitious** web applications.
|
||
|
|
|
||
|
|
Contributions and patches are welcome.
|