1. This site uses cookies. By continuing to use this site, you are agreeing to our use of cookies. Learn More.
  2. If you had a PIAF Forum account in the vBulletin days, log in with your old credentials. Otherwise, sign up again and we'll get you back in business as soon as we can.
  3. A serious FreePBX vulnerability has been reported. Update your Framework Module immediately. Click here for details.

NEW CallerID Superfecta 2.2.4: THE MODULE

Discussion in 'Add-On Install Instructions' started by tshif, May 11, 2009.

  1. tshif Guru

    Updated Superfecta Data Source for source-CanPagesCa.php

    Updated Superfecta Data Source for source-CanPagesCa.php
    :cheers2: Thanks to contributing developer jkiel, the
    Data Source for source-CanPagesCa.php has been upgraded and is now released and available in the Live Update repository.

    This is an recommended upgrade.

    Fixes: Issue #399 CanpagesCA website changed search results output

    source-CanPagesCa.php

    Has been updated and is NOW AVAILABLE within the Superfecta modules' built in data source update function.
  2. tshif Guru

    Updated Superfecta Data Source for source-Telco_Data.php

    Updated Superfecta Data Source for source-Telco_Data.php
    :cheers2: Thanks to code from contributing developer jkiel, and testing from lgaetz the Data Source for source-Telco_Data.php has been upgraded and is now released and available in the Live Update repository.

    This is an optional upgrade.

    Fixes: Issue #404 source telco-data doesn't support CAN, but could

    source-Telco-Data.php

    Has been updated and is NOW AVAILABLE within the Superfecta modules' built in data source update function.
  3. tshif Guru

    Netherlands CNAM data source has been renamed

    The CNAM source source-Netherlands.php has been renamed to source-Nummerchecker_NL to better support future additional Datasources for this region.

    Source-Netherlands has been depreciated and is no longer supported by Live Update. Source-Netherlands may be removed from your schemes, and replaced with source-Nummerchecker_NL.
  4. tshif Guru

    CNAM data source source-Enum has been renamed

    The CNAM data source source-Enum.php has been renamed to source-EnumQuery to better support future additional Datasources for e164 lookups.

    source-Enum has been depreciated and is no longer supported by Live Update. source-Enum may be removed from your schemes, and replaced with source-EnumQuery.
  5. tshif Guru

    Caller ID Superfecta: THE MODULE v 2.2.4 Is Here!

    Ho Ho Ho! – it’s the release of KringleFecta!

    [IMG]

    It’s the time of year when the desire to give presents and make merry starts to fill us with anticipation and delight. Santa will be along soon – and all us good little girls and boys will get their hearts desires on that special day. The “Developer Elves” who work on the CallerID Superfecta module have been hard at work to bring you this KringleFecta edition of the CallerID Superfecta.

    Happy Holidays From The CallerID Superfecta production team!

    It's been exactly one year (to the very day) since we released a new version of the CallerID Superfecta Module, and since this is possibly the last major release of the Superfecta 2.2.x series (we are preparing the groundwork for version 3.0) – it seems a good time to briefly recap Superfecta development for 2010. As the guy lucky enough to be the Superfecta project administrator, I’ll also answer three interesting questions that tend to surface fairly regularly. Those questions are Where did the Superfecta Module come from? What’s new in this release? And, What does the future hold?

    Where did/does the Superfecta Module come from?
    The shortest and best answer is, The Superfecta Module comes from people just like you, who contribute to the CallerID Superfecta, and other open source software projects. People who have the desire to produce something useful, and hope that others can enjoy using it for free.

    For example, when I originally created the CallerID Superfecta Module for FreePBX, there were two main motivators.

    First, thanks to Mr. Mundy, there were a few Nerd Vittles scripts floating around that were just the coolest little functions for your pbx that you ever did see! I really liked them – but I hated installing them. I thought some folks might even be stumped and unable to use them because of manual nature of their installation.
    One of the best was Ward Mundy’s Caller ID Trifecta, which Ward tells us was itself based on a another author’s previous work in Open Source Software. Ward released the Trifecta into the wild. As if in testimony to Open Source Software – his creation went on to be maintained and updated by the members of this forum. Renamed by Mr. Mundy during one of it’s previous upgrades to “Caller ID Superfecta”, it had been extended to include more sources of information (up to 5 at one time) than ever before.

    Second – I really wanted to be able to give something back to a community that had helped me so much when I was stumped – with so much professionalism and friendliness. Without PBXIAF and this Forum, I would have given up on VOIP as an idle plaything – impossible to rely upon. Instead, I’m a town crier extolling the virtues of VOIP – especially if you start with PBXIAF.

    There was just a bit of a problem with me contributing. I’m a LAMP neophyte, and far less experienced than those offering their help around this place already... So, I looked around for a project that would be of minimum scope that would let me try and gain a little experience doing something productive that I could contribute back to this community.

    Eventually, I hit on the idea of trying to figure out how FreePBX modules can be created, converting a few of my favorite existing scripts into modules that anyone could install in seconds with FreePBX, and trying to share that experience with anyone that wanted to hear it. (The first one was the Hotel Style Wakeup module.)

    During the development of the modules it became apparent that as an Open Software Projects, they would need some suitable public home. After flirting with many public options like Googlecode, and others, it became obvious that a dedicated site with all the trimmings of ticketing, documentation, and SVN under the same roof was the best choice; A site dedicated to the hosting of any and all software projects that might be associated with the use of our PBXIAF’s, and other distributions. That led to the creation of the Development Support site – a place where it was hoped that other folks who wanted to contribute would feel comfortable pitching in. It was especially important that first time contributors would feel welcome, and be brave enough to indulge their desires to contribute to open source software.

    Trust me when I tell you I never imagined what a great experience my involvement would be. If you have ever thought about contributing to an Open Software project – and were reluctant because you weren’t sure you had anything to offer – do yourself and the community a favor and jump in, the water’s fine!J

    Right now there are more than 100 registered contributors at the development support site – participating at various levels as their lives and interest dictate. What a GREAT response considering registering is akin to saying you’re about to start giving away free labor!

    The skill levels of the participants are just as varied. Folks who are professional developers pitch in along-side people like me (I am almost completely php impaired), and every skill level in –between, and there’s no blood in the water! There’s truly room for everyone serious about wanting to pitch in.

    The people I have been privileged to become acquainted with and work alongside on various projects have been generous and giving in the extreme. They get absolutely nothing out of their participation except our appreciation, and their pride in work well done. Their time and talents are donated freely to help make and upgrade many of the add-ons that we get for free and use everyday. To each one of them – I repeat my thanks for every moment they spent contributing to the projects they work on.

    Open Software Should Be Open
    It’s a rare and beautiful thing to see folks freely contributing to a coding project. But have a look around here at the PBXIAF forums and you see it; A lot of it. It may not be unique – buts it’s rare enough, and worthy of all our support. For that reason, a Development Support Site and SVN have been provided to host the Superfecta (and several other Open Source PBX projects, such as End Point Manager) development effort and provide a place for the distributed community development effort to thrive. (http://projects.colsolgrp.net) This new release of The Caller ID Superfecta is the latest exciting piece of software to be released through the Dev site. Virtually all work done on the module has been accomplished by members of this very forum – on a completely volunteer basis. All the code in the development site is 100% Open Source, nothing compiled, hidden, or obfuscated – because that wouldn’t be “Open Software”, would it?

    Happy Birthday! The Superfecta Module turns 2
    When I was preparing to write this introduction, I looked back to find the very first announcement I made when version 1.0 of the module was released. As it turns out, it wasn't too hard to find - as it was released right here in the PBX in a flash forums. http://pbxinaflash.com/forum/showthread.php?t=3747 , March 13, 2009, a mere 21 months ago.

    If you count the time I spent pulling out my hair, and trying to understand how to build a module in the first place, we can say that the caller ID Superfecta module for FreePBX has been under development for a total of a little less than two years. Of course, the basis for the caller ID Superfecta module was Ward Mundy's then community maintained script, the caller ID Superfecta.


    In technological terms, 21 months can be a long time, but I have to confess, the advances in the module during that time have been nothing short of amazing. For example, we have gone from 5 data sources to 49!

    See Part 2
  6. tshif Guru

    Caller ID Superfecta: THE MODULE v 2.2.4 Is Here! Part 2

    Caller ID Superfecta: THE MODULE v 2.2.4 Is Here! Part 2

    Evolution – Brief and Abridged
    Versions 1.x.x of the Superfecta module were almost a direct adaptation of the then-current version of the Superfecta script being maintained here in these forums.

    In version 2.0.0, the underlying architecture of Superfecta was changed to prepare for better support of caller ID schemes used outside of the United States, as well as other changes designed to enhance the configuration options available within Superfecta.

    In releasing version 2.2.0 (8/17/09) , the Superfecta development team addressed and closed every trouble ticket which had been filed against all version 2.0 releases. We also deployed some of the most exciting changes to the module yet: (1) The concept of CID Schemes – which allows the use of different sources for different inbound routes based on pattern matching on both CID and DID, and (2) Online Source Updating, which provides a completely interface driven way of updating data source scripts direct from the development live update repository.

    In version 2.2.1 (10/16/09) , the Superfecta development team addressed and closed every trouble ticket which had been filed against all version 2.0 releases, and added the basic core code required to support international CID for the very first time. All the data sources were made smarter, improving their speed. Version 2.2.1 released with 25 data sources, and was the first version to support the exciting online “live-update” feature for the data source scripts.

    In version 2.2.2 (10/29/09) , every ticket filed against 2.2.1 was addressed. Bugs in worldwide CID support, character set problems, and Scheme DID/CID matching rules were fixed.

    In version 2.2.3 (11/23/09), bugs in post processing, extended characters in the login, and refinements to live update were addressed. The companion windows program Winunciator, that speaks CID information was released as a companion product and data source. Version 2.2.3 was released with 32 data sources.

    So – what could we possibly add to that? I’m so glad you asked!

    I am delighted to announce the release and immediate availability of Caller ID Superfecta: THE MODULE Version 2.2.4

    What’s New in This Release of v2.2.4?
    This release, 2.2.4, is considered a major maintenance release and upgrade for the version 2.2.x series of the Superfecta module. But for the folks that like to create new data source scripts, its also a mini feature release too.

    More than 25 bug reports and feature requests were addressed. So many new data sources have been added in the last week – I have literally lost track of the number. Every time I turn around, jkiel or lgaetz has added another one! Such wonderful problems for a project admin to have – don’t worry guys – I can take it – hehe – Let the data sources roll! J

    In general, the developers have:
    • Cleaned up various minor code errors to eliminate background noise in the error log file.
    • Upgraded the flexibility of the CID / DID Rules for Schemes.
    • Added Exception Rules for the Superfecta Cache
    • Improved Pop Up mouse-over help.
    • Added and upgraded a bunch of Data-sources
    • Improved Installation / Upgrade / Uninstall functions

    Bug Fixes and Enhancements
    Beyond the 25 bugs and features, our Guru at Large jkiel included a few Stocking Stuffers in the form of new functions in the Superfecta API. These new functions help Superfecta get data from sources with more esoteric access requirements than simple unadorned http (such as cookies). He’s also released the first data sources taking advantage of some of the new functions available to data source authors. In fact, in this release John will have contributed at least 5 brand new data sources, and participated in the creation or upgrade of many, many more.

    And even though producing documentation is nobody’s expression of Joie de vivre, as the Pièce de résistance for his work on v2.2.4, John’s in the process of helping our volunteer documenters get the new functions listed and explained clearly in the Superfecta Developers Wiki (See! Some developers will participate in documentation.) It’s not done yet – but were trying! J Remember, when it comes to documenting, there’s always room for one more. Muhahahaa

    In general terms, while preparing this release, upgrades were made in 10 existing data sources. Those new versions began appearing in the live update function of the Superfecta module on December 17th, , 2010 .

    Our first 5 data sources for Australia make their debut in v2.2.4, along with sources for Argentina, Sweden, and 3 new or upgraded sources for Canada.

    Previous versions of the CallerID Superfecta module were….. Noisy in the logs. All the developers rolled up their sleeves for the effort of squashing this nuisance and when they were finished – as far as the error_log file is concerned, the Superfecta module is now zero-emission when no actual errors are present.

    Previous versions of the Superfecta Module could, when un installed under the right circumstances, leave your inbound routes inaccessible by outside callers. That problem has been corrected.

    CID Schemes
    Some of the most exciting enhancements in Superfecta are in the CID / DID Scheme rules area. The scheme rules allow you to use pattern matching in ways very similar to FreePBX. Using schemes you can:

    · Compensate for inbound CID’s of varying length – for example in multiple provider situations.
    · Determine by CID / DID rules which scheme(s) may be applied to inbound calls.
    · A lot more -

    Here are some rules to remember when dealing with Schemes:
    1. Superfecta treats each Scheme as a separate entity, and processes them in the order you have them listed.
    2. If a scheme has rules, and they fail for an inbound call, that scheme is not executed.
    3. Only the first scheme providing a CNAM match will be executed.
    4. Post Processing will only occur for data sources listed within the successful scheme.
    5. You should generally always have a catch all scheme at the bottom with no rules to handle unexpected situations.

    Support for CID and DID Pattern Matching Rules
    As we have for inbound call routing and trunk selection in FreePBX, CallerID Superfecta provides configuration options to specify both the DID, and CID rules to be used with each scheme. This function has been totally rewritten in Superfecta v2.2.4 to better support all the variations of the traditional pattern matching capabilities. If you had less than perfect success with rules before –revisit them again in release 2.2.4- you’ll find their flexibility can work wonders to extend the functionality of the Superfecta Module in special needs cases.

    See Part 3
  7. tshif Guru

    Caller ID Superfecta: THE MODULE v 2.2.4 Is Here! Part 3

    Caller ID Superfecta: THE MODULE v 2.2.4 Is Here! Part 3

    Thanks entirely to lgaetz, documentation to help you get the most out of CID / DID Rules, and Schemes is available here.:

    Don’t miss out on the amazing flexibility made available through CID /DID rules – lgaetz has done a great job providing plenty of info for you to get started meeting the needs of those special circumstances.

    Data Source Dependencies
    Remember, data sources can have dependencies upon certain versions of the Superfecta Module. If you’re running the latest version of the module, you shouldn’t have anything to worry about, but if you are adding data sources to prior versions, remember what you have read here. For example, with version 2.2.4 we have released some new data sources that require this latest version of the module to work. For those of you using a previous version of the Superfecta – pay attention to the pop-up text for each data source and note any requirements it may have for specific versions of the module. Or better yet, just upgrade to 2.2.4. All your old data sources are compatible with 2.2.4. You know you really want to upgrade, right? J

    Data Source Enum Renamed
    The data source Enum has been renamed to EnumQuery. When you upgrade to 2.2.4, you may end up with both. Support for source-Enum.php has been discontinued – so delete that data source and use source-EnumQuery.php instead from now on – it’s the same source.

    Data Report-Back
    Some data sources have a “Report Back” option which, when you enable it, causes a successful CNAM resolution to be Reported Back to its data source. This is primarily used when the data source is one that is maintained by user contribution. If a Report-Back enabled data source is part of the successful scheme, the CNAM collected will be reported back, or contributed to the data provider.

    Be conscientious with the report back option. If you enable it, take care to assure that you don’t have a generic source, such as Telco-Data, in the scheme. Doing so could cause you to send generic information such as SAN DIEGO, CA to the data source – which would be considered data pollution – since nobody will want to receive that data from this source in the future.

    Superfecta Cache
    Speaking of data pollution – the Superfecta Cache has been upgraded to support CID exclusion rules. If you use the Superfecta cache, you can now specify via CID pattern matching things that you do NOT want to go into the cache. This can be extremely useful – here’s a typical situation.

    Lets say you use the data source Trunk_provided as first priority because most of your calls come in over analog lines which provides decent and accurate CNAM data.

    However, there are circumstances where the trunk provided CNAM is different for each person calling you from within an organization, but the CID number is the same for all. In this case it is inappropriate to cache that CNAM data – but you want to use the cache for other sources in the same scheme.

    The solution is quick and easy with the new Superfecta Cache. Simply created a CID rule that either pattern matches, or lists explicitly (use both together if need be) the numbers you do not want cached and bingo! Situation solved. (We can all thank lgaetz for asking for, and jkiel for providing this extra cool, extra functional little upgrade to the Superfecta Cache data source.

    Check out the trouble/feature tickets at the dev site directly if you’re curious about any specific details – its all available site for anyone to review.

    Who did all this?
    As is always the case, this release would not have been possible without the significant contributions of many people – from those who report the bugs, to those that fix them, and those that help test the results. To everyone who stepped up during this last year to help with a new data sources, bug chasing, or coding – please accept my thanks, along with the thanks of everyone who has benefited from your efforts.

    For the release of version 2.2.4, PBXIAF forum member and dev site participant Lgetz (Lorne) has stepped up to the plate in a big way. He has created, or facilitated the creation and addition of several new data sources, as well as working with bug reports and other developers on resolving several important trouble tickets, and feature requests. His testing efforts have been tireless – and the module is better for it. Lorne also as helped several new contributors find their way to, and start contributing at the development support site. Thanks Lorne for all your efforts! The project has benefited greatly from your participation.

    Also contributing very significantly to this release has been PBXIAF forum member and dev site participant jkiel (John). John stepped into several of our most severe bug tickets and corrected them for us – as well as making ongoing significant contributions in planning for future versions of the module. John’s work in this release made the user-wish for new data sources for Australiacome true, and introduced the first group of extended API functions for data-sources that have more extensive requirements than simple http. In fact, he’s contributed more than 5 data sources already. Thanks for all you have already done, John!

    Making another kind of valuable contribution, forum and dev site member Atsak put up a bounty for a new Austrailian data source which he has already instructed us to release back into the community. Its in v2.2.4 as source-reversephones.com.au. Thanks Atsak - way to go.

    But, in the Spirit of the community, the developers have asked that you instead contribute the bounty to either PBXIAF, or the CSG Software Project Management site (the Developer Support Site), where it was created. In whichever direction you send your contribution, it will go directly into supporting either PBXIAF, or the Project's Developer Support Site. You can't go wrong! Then, just to make sure that our friends down-under know we're sorry for making them wait so long - the developers created 5 more sources for that region! See what you did Atsak??? :)

    What do we owe for all this?
    Developing good software is hard work and takes a lot of time. Doing that for free, when you already have a full-time job, as well as a "real life", can only be the result of having suffered repeated head injuries as a child.

    Of course I'm only kidding!

    In fact, doing all that for free can only be the result of having the most generous of spirits, and a genuine desire to contribute to the creation of open source software.

    I’m sure you will agree Lorne, John, and all our contributors deserve a lot more than only our thanks and appreciation for these great upgrades. I hope Karma rewards them richly!

    But, until Karma gets around to it, please join me in a round of applause and sincere thanks for forum members Lgetz, jkiel, nixi, zorka, adamgoldberg, mageminds, and Patrick_elx, and the anyone I managed to forget mentioning for giving us all a really nifty little surprise Christmas present: CallerID Superfecta: THE MODULE. V2.2.4. (The KringleFecta edition)

    Caller ID Superfecta: THE MODULE Version 2.2.4 May Be Downloaded from the Development Support Site at This Location.

    See Installation Instructions and Whats new in the next post.
  8. tshif Guru

    Installing / Upgrading to the CallerID Superfecta 2.2.4

    Caller ID Superfecta: THE MODULE V 2.2.4

    The Caller ID Superfecta has proven to be the most often downloaded module in the Development support site – and for good reasons. Everyone expects caller ID services with their telephone service. And WE ALL KNOW there’s only a few choices for getting it. We can pay our TSP’s for it – if available, we can pay an outside source for it, or we can use something like The Caller ID Superfecta for it.

    Additional Documentation Available
    User / Administrator Documentation
    When the caller ID Superfecta: THE MODULE was first released, the functions were so basic, and the user interface so straightforward -- little user documentation was ever really required.

    Because version 2.2.4 supports multiple caller ID schemes, and support for worldwide caller ID formatting schemes, the presence and use of certain capabilities may not be as immediately recognizable and obvious.

    In order to help you understand how to get the most out of caller ID Superfecta version 2.2.4, we're doing our best to produce end-user documentation at the development support site. Look here to see what exists today. Don't hesitate to contribute to the documentation effort if you have suggestions or recommendations about how others users may get the most out of caller ID Superfecta.

    Install and Upgrade
    This module is a direct upgrade of the previous Caller ID Superfecta. It can co-reside with the older, non-module version of Superfecta, or any other Caller ID solution, without difficulty.

    It will take less than 1 minute to complete the install. Upgrading will not wipe out your settings. (Settings from version 1.x of the module may be lost during upgrade – so make a note of anything you want to remember before the upgrade.)

    New Installs
    If you install this version of the module from scratch (not as an upgrade), all 49 data sources will be visible in the Superfecta user interface, and a basic selection of sources will be preconfigured for you in the default CID scheme. Customize these as needed for your circumstances.

    Upgrades
    If you install this version of the module as an upgrade from any version 2.x.x, all 49 data sources will be installed and made visible in the Superfecta user interface. Your selection and arrangement of data sources will be retained. Sources which required extra configuration will retain those settings in the new version of the data source. It’s a good idea to note any special configuration items before upgrade just in case . Any/All CID Schemes (Default, and any user created ones) will be retained.

    Important: If you have created your own data source, or performed custom modification to any of the Superfecta stock data sources – manually back them up to a safe location before upgrading the module – as these sources will be deleted without warning during upgrade and install.

    NOTE: If your installation uses / requires an htaccess file in the module folder – BACK IT UP BEFORE PROCEEDING. The upgrade process will remove it – you will have to restore it manually. (If you don’t know what I’m talking about, you probably don’t have one to worry about.)

    Installation:
    Step 1: Download the module to your desktop From here.
    (Generally, you'll want to select the most recent released of the Version 2.2.X Series.)
    Don’t decompress the archive!

    Step 2: Use a web browser to access FreePBX on your PBX. Choose Tools, Module Admin, Upload Module.
    Now, browse to the superfecta-2.2.X.tgz file on your Desktop and click the Upload button. Now click local module administration, scroll down and click on CID Superfecta and then the Install radio button. Now click Process, and complete the usual FreePBX install and reload process.

    Step 3: Use a web browser to access FreePBX on your PBX. Under Setup, Select CID Superfecta.
    You will be presented with configuration screen. Establish settings that make sense for your PBX, and Save your changes.

    The module installer has created the entry for Caller ID Superfecta in the FreePBX Caller ID Lookup Sources. The ID and Password Fields for the Caller ID Superfecta entry in the FreePBX Caller ID Lookup Sources area will be filled in by controls on the CallerID Superfecta Module Web UI.

    [IMG]


    Configuring Services
    As you may know, the current version of FreePBX can only assign ONE CallerID lookup source per inbound route. CallerID Superfecta gets around this limitation quite nicely – it allows you to configure from a currently available total of 49 different sources, to be used in any combination you see fit.

    Using the ENABLE and DISABLE radio buttons, select those services you wish to use for your Caller ID. Please note that some data sources (Example: SugarCRM, WhoCalled, and others) require additional configuration items to function. Those that do will display “===>” to the right of the data source name. Clicking on such a data source will expose its configuration options.

    Choose the order in which the sources are used by clicking the Use the Up and Down arrows to change the order to one that makes sense for your circumstances.

    Support for Multiple Caller ID schemes
    Early versions of the caller ID Superfecta were not well equipped to deal with a variety of formats for inbound caller ID. For example, a PBX with two inbound service providers, one delivering caller ID in 10 digit format, and one delivering caller ID and 11 digit format-caused some real pain (and probably some “by hand” editing) for the system administrator.

    Support for CID and DID Pattern Matching Rules
    As we have for inbound call routing and trunk selection in FreePBX, caller ID Superfecta provides configuration options to specify both the DID, and the caller ID rules to be used for each schema. This function has been totally rewritten in Superfecta v2.2.4 to better support all the variations of the traditional pattern matching capabilities.

    Using the DID number and CID rules configuration fields allows you to direct inbound calls to a Superfecta Schema whose data sources, search order, and other options have been optimized for calls matching specific criteria in CID and DID.

    This concept of dealing with multiple formats of caller ID as a "caller ID context", or Schema, originated right here in the forums, with user patrick_elx. Thanks for that extremely good idea Patrick! (Patrick has since participated in Superfecta development.)

    See Part 2
  9. tshif Guru

    Installing / Upgrading to the CallerID Superfecta 2.2.4 Part 2

    Installing / Upgrading to the CallerID Superfecta 2.2.4 Part 2

    General Options
    The ID and password in General Options is required when your PBX runs on Apache Security (Such as PBXIAF, and TrixboxCE). This will generally be your MAINT/maintpassword combination.

    If you run a distro when you use the FreePBX ACL (credentials) method instead of Apache security, these two fields may be left blank. (PBXIAF 1.0 in ACL mode, Foncordiax, Fonica PABX distributions.)

    Lookup Timeout allows you to define how long Superfecta waits on a result from any data source before giving up and moving on.

    Spam Count Threshold allows you to define the number of times a phone number is reported as a SPAM source before Labeling it as such. For now, only the source PhoneSpamFilter uses this value. As other sources that use this type of threshold are added, they will use this value as their threshold also.

    CID Prefix URL allows the caller ID Superfecta to trigger an additional outside process when the caller ID function is run. For example, this feature might be used in a call center to allow the system to automatically bring up a customer ID number for the customer service representatives' use. The syntax looks like this example:

    Code:
    [COLOR=black][FONT=Arial][URL="http://nowhere.example/"]http://special.someonescallcenter.org/get_customer record.php?phone_number=[thenumber][/URL][/FONT][/COLOR]
    
    In this example, the Superfecta would send this URL as it begins the lookup process. (This function is provided for advanced users with advanced needs.)

    Superfecta Instant Live Update Functions
    The Superfecta Live Update function provides a way to instantly update data sources, or install new ones, from inside the Superfecta module with just few simple mouse clicks.

    Checking for Data Source Updates
    Placing a check mark in the “Check for Data Source File updates online” box, and clicking on any link within the Data Source section of the user interface, or on the debug button, the system will -

    • Displays a link which says “Update Available” to the right of any data source for which there is a newer version available.

    To perform the update for a data source, click the link. Superfecta will download and install to the module the new version of the data source file.

    Data sources which have been updated in this manner will display the Roll Back Icon (a light blue arrow) to the left of the data source name. Clicking on the roll-back icon will cause Superfecta to roll back to the previous version of the data source file. (The roll-back copies are locally cached on your PBX. Only the most recent previous version is available in this way. You can not roll back multiple generations.)
    • Displays a drop down list box containing a list of all the available (but not currently installed) data sources.
    You may install any listed data source by selecting it in the drop down box, and clicking the upward pointing arrow to the left of the box.


    Data sources which have been added in this way appear on the list of installed data sources, and may be enabled, disabled, configured and sorted normally.

    Installed data sources that have no source file equivalent on the Superfecta live update repository will have the phrase unsupported module displayed to the right of the data source name. In this case, unsupported means that it is unsupported by the live update feature. It also means that when you perform an upgrade, this data source will be deleted permanently – since it’s not recognized by the Superfecta.

    Important: If you have created your own data source, or performed custom modification to any of the Superfecta stock data sources – back them up to a safe location before upgrading the module – as these sources will be deleted without warning during upgrade and install.

    Some data source files require additional configuration – those that do will display “===>>” to the right of the data source name. Clicking on such a data source will expose its configuration options.

    That’s all there is to it!

    See Part 3
  10. tshif Guru

    Installing / Upgrading to the CallerID Superfecta 2.2.4 Part 3

    Installing / Upgrading to the CallerID Superfecta 2.2.4 Part 3



    Superfecta Debug Functions
    The Debug functions are built into the application. The debug feature has lots of uses, and it’s easier to use than ever. The debug system takes the number you enter, and runs it through all the sources you have selected. It displays the results for each source, as well as the time it took to get the result. Using this information, you can now make more informed choices about which sources you want to use, and in what order you want to use them.

    The last bit of info in the debug window shows you which data source would have been used, and how long it would have taken to do so.

    Find out which sources give the best data for your use, which sources are fastest and slowest, and use this information to determine exactly which service you want to use, and in what order.

    New in Debug with Version 2.2.4: The debug function now displays extended debug information for data sources, helping to pinpoint problems with individual data sources during troubleshooting. You may see data source errors reported next to the word “Notice” in bold. These error messages help the developers track down problems with the individual data sources. Generally, errors reported here do not affect Superfecta systemically, but only the individual data source for which the errors appear. They are usually safe to ignore, but can be reported to the developers for follow up when needed.

    Superfecta News Feed
    Did you know that you can easily stay on top of all the news related to the development effort for Caller ID Superfecta: THE MODULE?
    It's true - and its really easy using the Superfecta RSS news feed.
    To sign up for the feed, visit the Superfecta News Page, go to the bottom of the page, and use the "Atom" link at the bottom of the page to subscribe.
    Anytime Superfecta news is announced there - it will show up in your feeds.

    Conditions/Prerequisites:
    This module is compatible with the security models used in, and has been tested with the following distributions:
    PBX In A Flash
    TrixBOX CE
    The Module’s wiki Page is here.
    The Module’s Development Support Site is here.


    Asterisk Version Compatibility
    This module has been tested and found to work correctly with Asterisk versions 1.4 and 1.6. (There has been no formal testing on Asterisk 1.8 – share your experiences with us if you deploy on Asterisk 1.8 Systems.)

    FreePBX Version Compatibility
    This module has been tested and found to work correctly with FreePBX versions 2.5 through 2.8

    PHP Version Compatibility
    This module uses and requires certain php functions like php-mbstring, and asterisk14-curl.i386. (More information here) By default ALL Versions of PBXIAF are CallerID Superfecta-ready with all required php dependencies already installed.

    Whats Next for the CallerID Superfecta?
    Well – I get into trouble when I talk to much – but there are many things being discussed. Don’t tell anyone I said so, but future versions of the Superfecta could incorporate things like simultaneous (instead of linear) polling of your CID Schemes’ data sources, a community driven CID/CNAM data source & portal for us all to have for free, and maybe even compatibility with non-Asterisk/FreePBX based distributions. (wink)

    Is there some function or feature that you believe will help keep CallerID Superfecta at the leading edge of CallerID solutions? Well don’t just think about it – talk about it!

    The best way to get your 2 cents worth of impact into the future of Superfecta is to speak up now while it is being imagined. If you already have an ID at the development support site, log your thoughts in the cases that exist for these discussions – Non dev site members, we want ot hear from you as well! Chime in here or any where you like. The Superfecta Module project always works best when YOU get involved. J

    Calling all Tinkerers and Fixers, Coders and Developers
    Whether you've already helped out by contributing to the caller ID Superfecta, or whether you been lurking in the background just waiting for the right time to step forward -- this may be the perfect time.

    The caller ID Superfecta needs you! Sign up at the development support site, and pitch in. Help create and test a new data source for the caller ID Superfecta. Whether it be for someone in your own region, or for someone far far away, give the gift of caller ID to someone this holiday season by contributing your skills to creating a new caller ID Superfecta data source.

    To get started, navigate to the development support site for the caller ID Superfecta & sign up. Once your account is activated, just let the project administrators (of the projects are interested in) know and they will add you to their projects.

    In the case of the Caller ID Superfecta project, you'll be developing, contributing, and enjoying giving the gift of caller ID in no time at all.

    And finaly, as always - we want to know how this version of the CallerID Superfecta works for you -

    Until next time - Happy Holidays!
    -tshif
  11. wardmundy Nerd Uno

  12. lgaetz Pundit

    And while tshif (Tony) thanks everyone for the latest release of Superfecta (KringleFecta!) allow me to thank you Tony, for doing what you do for the Community. The infrastructure and leadership provided for this project make it hard for me to imagine a smoother process. A casual user will probably not be aware of the code that was polished and new functionality introduced in 2.2.4, and virtually all of the work was done within the three weeks preceeding its release.

    By way of full disclosure, I confess that more than a few of the new features come right off my personal Superfecta wish list; a list that had been slowly growing since I first installed the module. And although my initial involvement in the project was motivated purely out of selfishness, it has been no less rewarding. Let that be a lesson to all, pitch in and help where you can, if for no other reason than to get the functionality you need yourself. If you need it someone else does too.

    Merry Christmas
    Lorne
  13. Really? Does that mean you're no longer turning up your nose at contributions from folks who don't want to be considered "developers?"

    If that's really so, then I invite you to take another look at my revisions to the Who Called script in post #541 in this thread, and to the TelcoData.us script in post #543. I believe both of those offer significant improvements over the ones you're currently using, but at the time it seemed you would not consider them because I didn't consider myself a developer and didn't want to join your developer site. If what you've said above means you're now reconsidering that policy, then I'll once again offer you those scripts, and hope that maybe this time you'll give them some consideration.
  14. tshif Guru

    :blush5: Wow - thanks for the extreemly kind words.

    Lorne's words here could not be more true. Those kind folks that roll up their sleeves, pitch-in and make all our wishes come true for new functions or improvements on old ones also hold serious sway in planning for the future of Superfecta. Beyond any doubt - they are the heart and soul of the Superfecta project.
  15. jkiel Guru


    We've been looking into this here, but I didn't have time to get it ready for 2.2.4 release. Should be able to push it out in a live update soon though.


    I recently made some minor changes to TelcoData, and until then had no real experience with it. I like your approach of eliminating the area code validation. Thanks for pointing this out -- I'll look into it.
  16. The only thing I don't like about my approach on that one is that I want to use it at the top of the list for spam validation, but since it's not as good as some of the other sources for name lookup, I run a second copy near to the bottom of the list that only attempts to get a name. I don't mind having two copies of the script (and I do realize I could use a symlink, but it's not that big), but maybe there should be a Who Called SPAM script and a Who Called LOOKUP script, so folks wouldn't be confused. The only real difference would be in the options presented, and perhaps a bit of code. But really, I see Who Called as being far more useful in making a spam determination than as a name lookup service.

    I like it too :D , particularly that it will give you a location for just about any NANP number (including the Caribbean island nations that are in the NANP) if you don't restrict it to only certain area codes.

    Thanks for giving this some consideration, and thank you to everyone who has made this module what it is today.
  17. tshif Guru

    The Developer Support Site will be undergoing maintenance beginning NOW, for approximately the next ten minutes.

    Please excuse any inconvenience.

    Update: Maintenance Complete
  18. lgaetz Pundit

    You should be able to do this using the same lookup source code by calling it in two different schemes. You can configure the two instances separately in each.

    Lorne
  19. Have to admit you've lost me there. I thought that any incoming call was only processed by one scheme. Are you saying there's a way to chain schemes?
  20. lgaetz Pundit

    Yep. If the first scheme fails, it cascades to the second and so on. Detailed description here

    Lorne

Share This Page