adding new blog entry and updating skipping call routing location and… (

#1123)

* adding new blog entry and updating skipping call routing location and links #1119

* fixing broken docs links

CONTRIBUTE.md

@@ -16,6 +16,19 @@ To run code coverage, you can run `make coverage`.
 
 Use `$this->withoutExceptionHandling()` in your test classes to see the underlying 500 error during your tests.
 
+### Docs
+
+1. Go to `cd src/docs`
+2. Run `npm run start`
+
+You should be able to see the documents update as you edit files at http://localhost:3000.
+
+To test building the docs run:
+
+```shell
+npm run docusaurus build
+```
+
 ### API Docs (WIP)
 
 This only works locally right now.

src/docs/blog/2021-08-01-merging-yap-post/index.md

@@ -1,7 +1,7 @@
 ---
 slug: merging-yap-post
 title: Merging Yap Servers
-authors: [fortysevenbot]
+authors: [dgershman]
 tags: [yap]
 ---
 

src/docs/blog/2024-08-24-pr-extension-hack.md

@@ -0,0 +1,30 @@
+---
+slug: pr-extension-hack
+title: Hacking Yap to Add a PR extension
+authors: [dgershman]
+tags: [formats, yap]
+---
+
+# Hacking Yap to Add a PR extension
+
+You can add a Public Relations or other miscellaneous extensions by doing the following, and leveraging the [Menu Options](/general/menu-options/) and the [Custom Extensions](/helpline/custom-extensions/) option.
+
+1. Update or set a digit map as follows adding a new option.  As see below we added a new option for pressing 3.
+
+```php
+static $digit_map_search_type = ['1' => SearchType::MEETINGS, '2' => SearchType::VOLUNTEERS, '3' => SearchType::CUSTOM_EXTENSIONS];
+```
+
+2. You will have to add a voice green recording that states what all the options are because by default the custom extension is a hidden menu option in that the spoken voice feature will not indicate it is there.  You set this by placing an MP3 or WAV file on a webserver and referencing it with [this setting](/general/voice-greeting/).
+
+3. You will create a new setting that indicates what each custom extension is and what phone number it goes to.  For example if you wanted extension 1 to go to 555-555-1212 you would set this as below.
+
+```php
+static $custom_extensions = [1 => '555-555-1212'];
+```
+
+4. Once that is done you will create another voice recording indicating what each custom extension will route to.  You can include as many as you want.  The important thing to note is that your custom recording should inform the caller to press pound after they enter the extension number.
+
+```php
+static $en_US_custom_extensions_greeting = "https://example.org/customext.mp3";
+```

src/docs/blog/authors.yml

@@ -1,11 +1,11 @@
 pjaudiomv:
-  name: Patrick Joyce
+  name: Patrick J
   title: BMLT Contributor
   url: https://github.com/pjaudiomv
   image_url: https://github.com/pjaudiomv.png
 
-fortysevenbot:
-  name: FortySeven Bot
-  title: BMLT Bot
-  url: https://github.com/fortysevenbot
-  image_url: https://github.com/fortysevenbot.png
+dgershman:
+  name: Danny G
+  title: BMLT Contributor
+  url: https://github.com/dgershman
+  image_url: https://github.com/dgershman.png

src/docs/docs/general/01-setup.md

@@ -22,7 +22,7 @@ static $bmlt_password = "";
 
 6. Try testing that your application actually is functioning properly by opening a browser http://example.com/index.php.  
 
-7. You will need to set up a Twilio account, and do the following.  Purchase a phone number (typically you would buy one for your locale, tollfree is pretty much unnecessary these days).  Configure that number to point to a Webook.  It would be something like https://example.com/index.php.
+7. You will need to set up a Twilio account, and do the following.  Purchase a phone number (typically you would buy one for your locale, tollfree is pretty much unnecessary these days).  Configure that number to point to a Webook.  It would be something like https://example.com/index.php.  If you want to skip helpline call routing you can do that with the instructions [here](skipping-helpline-call-routing).
 
 8. You will need to set up a new MySQL database.  Be sure to set up backups on your database as well.  Your hosting provider may cover this more.
 Once you've done that, set the following in your config.php.