DESCRIPTION

The Basic Meeting List Toolbox (BMLT) is a powerful, database-driven system for tracking NA meetings. It is NOT an official product of NA. Rather, it is a project designed and implemented by NA members, and meant to be used by official NA Service bodies.

This project is a CMS "base." It has a lot of functionality built into it, such as administration and various renderers, but in a "CMS agnostic" fashion. This class is an abstract class that needs to be subclassed and extended. It uses a Presentation Model pattern, and extensions are responsible for supplying Model storage management and View connectivity.

REQUIREMENTS

The project requires a functioning BMLT root server. It does not implement a root server, but connects to an existing one. It requires PHP 5.0 or above.

This class uses the BMLT Satellite "Driver" Class, which is available on GitHub, here.

To pull the latest driver run composer install.

INSTALLATION

The instructions for employment of this class are on this page.

CHANGELIST

Version 3.11.12 - November 17, 2023

• Various PHP and JS fixes.

Version 3.11.1 - September 6, 2022

• Ternary fix.

Version 3.11.0 - September 6, 2022

• Updates driver to use JSON instead of XML endpoints.

Version 3.10.0 - September 22, 2019

• Added the "Australia" theme.
• Added location_info field to [[bmlt_table]] and [[bmlt_quicksearch]] shortcodes.
• Fix for service bodies with multiple children not being selected.

Version 3.9.12 - December 24, 2018

• Fixed an issue where the Enter key would not submit the meeting search form when using Firefox on standard [[BMLT]] shortcode.
• Fixed an issue with Google Map API being called wrong.

Version 3.9.11 - December 24, 2018

• Added sorting to map search for service bodies and formats.

Version 3.9.10 - December 20, 2018

• Fix for the BMLT_CHANGES shortcode.
• WML 1.1 fix for BMLT_MOBILE shortcode.
• ROOTPATH must ALWAYS be defined, but if its not we must account for that properly.

Version 3.9.9 - December 14, 2018

• Form javascript URLs correctly when behind a firewall or load balancer.

Version 3.9.8 - December 7, 2018

• Only define ROOTPATH if not defined already.

Version 3.9.7 - December 5, 2018

• Added the "NERNA" theme.
• Minor adjustments to the German localization.

Version 3.9.6 - November 16, 2018

• Fixed dependency issues.

Version 3.9.4 - November 15, 2018

• Moved the home Git repo to GitHub.
• Added the BlackWhiteAndRed theme.
• Migrated to use composer instead of submodules.
• Compatibility tested for WP 5.0.0.

Version 3.9.3 - July 31, 2018

• Minor warning fix for missing lang.
• Added a line to the AJAX URI calculator to allow the server admin to "hardcode" an HTTPS port, in case the server is misconfigured.
• Added fix for possible XSS hijack in the fast mobile form.

Version 3.9.2 - February 11, 2018

• Minor adjustments to the Swedish localization.
• Added a new "Supermax" option to the auto-radius settings.
• Moved the Quicksearch JavaScript into the header.
• Doing a better job of filtering out unnecessary header JavaScript.

Version 3.9.1 - January 4, 2018

• Fixed an issue where some translated versions had bad settings in the BMLT options initial map type.
• New Italian Translation.
• Fixed a bug in the admin screen where it was possible to cause problems with translated strings containing apostrophes.

Version 3.9.0 - December 31, 2017

• There was a minor bug in the [[bmlt_table]] CSS for the GreenAndGold theme.
• Added the admin UI for the auto-search radius.

Version 3.8.3 - November 10, 2017

• With the new security regimens out there, the cURL spoofed UA may cause problems. I added "cURL" to it, and updated the other UA components.

Version 3.8.2 - October 8, 2017

• The "fix" in 3.8.1 broke certain other installations. That should be fixed here.

Version 3.8.1 - October 8, 2017

• The 3.7.1 version had an anonymous function pointer that caused some LAMP servers to puke (They shouldn't). It is no longer anonymous, and that should fix it.

Version 3.8.0 - October 8, 2017

• Addressed some issues with the classic [[bmlt]] shortcode -made it more responsive.
• Added some internal infrastructure for possible future capability to select different default auto-search radius.

Version 3.7.1 - September 24, 2017

• Addressed an issue where string searches were not being done properly with certain non-Roman character sets.
• Fixed an issue with the [[bmlt_quicksearch]] shortcode, where you could get an empty search result if none of the meetings in the result set had formats.

Version 3.7.0 - September 24, 2017

• Added Spanish localization -FINALLY! Thanks, Costa Rica!

Version 3.6.2 - September 21, 2017

• The mobile client was not displaying correctly.

Version 3.6.1 - September 19, 2017

• There was a bug introduced by the previous release. The standard [[BMLT]] shortcode's images were not displayed.

Version 3.6.0 - September 18, 2017

• Added the [[BMLT_QUICKSEARCH]] shortcode.

Version 3.5.1 - September 11, 2017

• There were still outstanding issues that needed to be addressed.

Version 3.5.0 - September 10, 2017

• Added the capability to have different localizations apply to different settings.
• Rearranged the order of fields in the Admin Page to group localization functions better.
• Fixed a couple of minor issues with the [[simple_search_list]] shortcode.

Version 3.4.7 - June 17, 2017

• Added a workaround for nonstandard SSL certs.

Version 3.4.6 - May 18, 2017

• Added Support for a per-setting Google Maps Region Bias.

Version 3.4.5 - March 17, 2017

• Added blank "index.php" files to all the directories to prevent listing directories.

Version 3.4.4 - March 12, 2017

• Added a fix to the [[BMLT_TABLE]] shortcode that ensures that empty columns in the table get non-breaking spaces if the value is empty.

Version 3.4.3 - January 1, 2017

• Enhanced the "GNYR2" theme.
• Fixed a bug in the fast table display, where venue names were not being displayed.
• Couple of minor tweaks in the Google API includes. Probably makes no difference.

Version 3.4.2 - December 13, 2016

• Added the "GNYR2" theme.

Version 3.4.1 - November 6, 2016

• There was one more place in the mobile implementation that needed the key.
• There was an error in the JavaScript in the mobile shortcode.

Version 3.4.0 - October 16, 2016

• Reintroduced support for the Google API Key.

Version 3.3.9 - May 22, 2016

• Now detect escape key to close meeting details overlay.
• The mobile JS file was importing a non-HTTPS Google Maps API. I changed this to use the HTTPS version.

Version 3.3.7 - May 2, 2016

• Fixed a very minor issue with the table styles, where they were not being properly optimized (makes the page load a teensy-tiny bit slower).
• Added the ability to load only a selected theme for the bmlt_table shortcode (only used by BMLT Basic).
• Changed the README markdown to adjust for Atlassian's new format.

Version 3.3.6 - April 21, 2016

• Continuing refactoring for documentation purposes.
• Added more Doxygen support. There is now a "doc" directory.
• Made it so that the details in the standard shortcode can be dismissed by clicking anywhere. I also now display a visible translucent mask.
• Fixed some style issues with the default display on Drupal. The default Drupal styles clobber the built-in ones, so I had to reinforce the built-in ones a bit.

Version 3.3.4 - April 13, 2016

• Refactored to make the code more straightforward and reusable.
• Refactored this file for better markdown display.
• Fixed a bug, in which the proper throbber was not being displayed where multiple themes are on the same page for the bmlt_table shortcode.
• Added a "Complex Table" preset to the unit test (Displays multiple bmlt_table shortcodes).

Version 3.3.3 - April 9, 2016

• Fixed a bug that could bork the bmlt_table shortcode when there are no parameters specified.

Version 3.3.2 - April 9, 2016

• Added a "breaker" div element to the bmlt_table display.
• Work on improving code quality.
• Added more style hooks to the bmlt_table shortcode display.
• Fixed a bug in the simple and table shortcodes that didn't honor just the settings ID (without the "##-##" splitter).

Version 3.3.1 - April 6, 2016

• Made the weekday tab overflow hidden.
• The format circles now float to the right.
• Added a display for days with no meetings.
• Fixed a bug in the bmlt_table shortcode, where the loading throbber would get replaced too quickly when selecting weekday tabs.
• Corrected a bug that allowed "00:00" times (should be "Midnight").
• Fixed a bug in the "simple map search" that displayed the info windows offset.

Version 3.3.0 - April 4, 2016

• Made it so that we can have specialized themes, amied at only certain shortcodes.
• Complete rewrite of the bmlt_table shortcode. Made it so that it can have simpler theming and be more responsive.

Version 3.2.4 - April 1, 2016 (Happy April Fools'!)

• Broke the table styling out into separate files that are all loaded at once. This allows a lot more flexibility when implementing the table display.
• Tweaked the GNYR style.
• The JavaScript had a fundamental error that prevented multiple instances of the table. That's been fixed.

Version 3.2.3 - March 30, 2016

• Got rid of an undeclared variable warning.
• Fixed a bug that caused rendering issues with the new table shortcode on Internet Exploder.
• Fixed a minor style issue, where the selection triangle would flow below the text in large text situations.
• Changed the styling for the selected header triangle to make the table display a bit more responsive.

Version 3.2.2 - March 29, 2016

• The JavaScript errors were more extensive than first thought. They should really be fixed, now.

Version 3.2.1 - March 29, 2016

• Fixed a JavaScript bug introduced at the last minute in 3.2.0.

Version 3.2.0 - March 29, 2016

• Fixed a style problem with the default search, where the map and text might be outdented by 8 pixels.
• Fixed the "Google Maps included two or more times" warning.
• Removed unnecessary new search and duration items from admin page.
• Fixed an issue where WordPress would sometimes HTML-entity the ampersand (&) character.
• Added a very significant new shortcode: bmlt_table.

Version 3.1.1 - March 16, 2016

• Added support for cookie- and HTTP query-based language selection.

Version 3.1.0 - March 7, 2016

• Added Italian translation.
• Some fairly fundamental changes to support HTTPS.

Version 3.0.28 - August 15, 2015

• Added Portuguese translation (Brazil).

Version 3.0.27 - May 25, 2015

• Removed the "0" timeout from the location determination code in the basic BML shortcode handler, in an effort to address an IE11 issue.
• Fixed an issue with the results of nouveau map searches returning unsorted.
• Fixed a few CSS errors in the themes.

Version 3.0.26 - January 31, 2015

• Fixed an issue with the extra fields display in the regular shortcode display details.
• Fixed an issue where the arbitrary fields were actually creating too many results.
• Now hide the distance_in_km/miles parameters in the meeting details (these are internal parameters).

Version 3.0.25 - November 22, 2014

• Fixed a CSS issue with the admin display map. Some themes (especially responsive ones) declare a global max-width for images. This hoses Google Maps, and has to be compensated for.
• Added full support for arbitrary fields. This was an important capability that was left out after Version 3.X

Version 3.0.24 - July 31, 2014

• Added a user agent to the cURL call, as some servers filter out cURL.
• Fixed an annoying admin bug that could cause new options to report an incorrect ID.

Version 3.0.23 - July 17, 2014

• Added Danish localization.

Version 3.0.22 - February 28, 2014

• Fixed a small bug in the add new settings handler.

Version 3.0.21 - February 22, 2014

• Some work to make the code easier to debug, and also to account for non-standard TCP ports.

Version 3.0.20 - December 31, 2013

• Fixed a character set issue that affected Internet Exploder.

Version 3.0.19 - December 7, 2013

• Added French localization

Version 3.0.18 - September 7, 2013

• Minor German localization corrections.
• Removed the useless "New Search URL" text box from the admin.
• Fixed a number of JavaScript issues with the bmlt_mobile shortcode.

Version 3.0.17 - July 1, 2013

• Corrected German localization.
• Added the ability to specify which day weeks begin (in Europe, it is common for weeks to begin on Monday).

Version 3.0.16 - May 22, 2013

• Added German localization.

Version 3.0.15 - May 19, 2013

• Fixed a small issue with the admin sheet, where entering text into the CSS box would not immediately trigger a "dirty" sheet.

Version 3.0.14 - May 18, 2013

• Fixed a possible issue with some initial calls being pooched by ampersands being represented as '&' in the URI.

Version 3.0.12 - May 16, 2013

• Added some code to reduce warnings in Drupal 7, if modules use nested arrays in the parameters.

Version 3.0.11 - May 13, 2013

• Reduced the number of times that the marker redraw is called in the standard bmlt shortcode handler.
• Fixed an issue with CSS that caused displayed maps to get funky.

Version 3.0.10 - May 5, 2013

• Fixed a bug, in which the first set of results for a search would display too many "red" map icons.

Version 3.0.9 - May 4, 2013

• Removed some PHP warnings.

Version 3.0.8 - April 28, 2013

• Added support for display of military time.

Version 3.0.7 - April 21, 2013

• The string search was being improperly handled. This has been fixed.
• Moved the project to Bitbucket.

Version 3.0.6 - April 18, 2013

• Improved the curl call functionality.

Version 3.0.5 - April 16, 2013

• Fixed a bug in the Swedish translation.

Version 3.0.4 - April 15, 2013

• Fixed a bug caused by the modifications for the new admin browser.

Version 3.0.3 - April 15, 2013

• Fixed a bug in the new Swedish localization.

Version 3.0.2 - March 30, 2013

• Added a default duration.
• Uncommented the adjustment for grace period.
• Added a link to the Google Maps for each meeting's details.
• Fixed a bug that screwed up localizations.
• Added a new Swedish localization.
• Updated the driver to preserve the session across the curl call.
• Added support for a "logged in" mode. This allows the plugin base class to be used by observers, in the root server.

Version 3.0.1 - January 28, 2013

• Fixed an issue that caused conflicts with some installations.

Version 3.0.0 - January 26, 2013

• Substantial rework to support new functionality.
• Decided to make it version 3.0, in order to coincide with the new plugins.

Version 1.2.4 - May 13, 2012

• Fixed a nasty bug in the admin interface that could create multiple empty settings.

Version 1.2.3 - April 27, 2012

• added some JavaScript "hooks" to allow more precise control of the new map search.

Version 1.2.2 - March 28, 2012

• Added an alert to the new map search, if no meetings were found in a clicked search (before, there was no alert).

Version 1.2.1 - December 31, 2011

• Removed some errant CSS.
• Now strip out the bmlt_mobile shortcode if the page is not a mobile page. This allows the shortcode to be used, as the comment version is stripped by "code cleaners."

*Version 1.2.0 -November 22, 2011

• Added the ability to have multiple localizations. It's a bit clunky, but this is the best way to get it working.
• Corrected some minor validation issues with the new map search DOM tree.

Version 1.1.7 - September 2, 2011

• Fixes a JavaScript Error with the new map search on Internet Explorer.

Version 1.1.6 - August 17, 2011

• Minor fixes to the default styles in the themes, in order to make the info windows look better.

Version 1.1.5 - August 16, 2011

• Workaround for a Firefox bug that renders the popup menus in the info windows worthless.

Version 1.1.4 - August 12, 2011

• Fixes a couple of minor theme/style issues.
• Mitigates a strange Firefox bug that caused weird page loads when closing the location area.

Version 1.1.3 - August 8, 2011

• Implements an entirely new, Google Maps API V.3-based map search.

Version 1.1.2 - July 16, 2011

• I now check for an ob_level before doing an ob_end_clean(). This is because notices were being posted when there was no ob_level.

Version 1.1.1 - July 9, 2011

• Added unit tests for the new change capabilities.

Version 1.1.0 - June 25, 2011

• Added the capability to specify changes.

Version 1.0.8 - June 20, 2011

• Added a connection to a specific localhost BMLT root as a default, if the server is localhost (specific to the development machine).

Version 1.0.7 - June 19, 2011

• First release as a factored project.