Overview
Profile Widgets are quick
and easy way to bring LexisNexis® Martindale-Hubbell® Lawyer and Law firm
profiles to your site. It will help your users to learn more about the
lawyer or the law firm right from your website/application without
having him to leave the page.
Lawyer and Law firm Profile widgets are simple JavaScript modules that you can place on your HTML pages. The widget only shows few elements of the Lawyers.com or martindale.com profile. Because
Lawyer and Law firm profiles can vary in detail depending on the
information available, the widget will re-size vertically to the size of
the content in the profile widget. The widget does not re-size
horizontally. You can put the widget on a page as many times as you
want.
To use the Profile widget, you must agree to the terms of use and privacy policy of Martindale-Hubbell®. When you display the widget, you
must display the entire widget interface and may not cut off or obscure
any portion of it. Martindale-Hubbell® reserves the right to make any changes to
the widget at any time.
Depending on what audience you serve - consumers or business, you can
choose one of the two versions of the widget. The basic differences
are-
- The links on one version go to Lawyers.com and the other go to martindale.com. Lawyers.com is a consumer facing website and martindale.com is a legal professional/business facing site
- One says Powered by martindale.com and the other says Powered by Lawyers.com.
If your website audience is consumers, then use Lawyers.com else use martindale.com. Below are examples of the Lawyer and Law firm widgets for each option -
ORG_ID and FLID
The Martindale-Hubbell® database has two kinds of identification elements for organizations:
-
Each
Organization, at its highest level, is identified by a unique number
called ORG_ID. This is assigned to the main office of the law firm. These numbers vary in length but are usually 6 or 7
digits.
- A Law firm can
have multiple offices listed in Martindale-Hubbell® database. Each
office location of a firm is assigned a Firm Listing ID (FLID). This is
usually a 6-9 digit number. There can be
multiple FLIDs associated to one ORG_ID.
If you want to display information about a firm in a specific office location, you will use the FLID.
Otherwise, to receive general information about the firm, you will use ORG_ID .
ISLN and ALID
The Martindale-Hubbell® database has two kinds of identification elements for lawyers:
- Each lawyer is
identified by a single International Standard Lawyer Number (ISLN), the
industry standard for tracking individual lawyers throughout their
careers.
- A lawyer can have multiple Attorney Listing IDs (ALID). Each ALID corresponds to an office or a firm at which the lawyer works. For each ALID, the lawyer may have different information, such as position and contact information.
If you want to retrieve specific information about a lawyer working in a specific office, use the lawyer’s ALID. Otherwise, use the ISLN to retrieve generic lawyer information.
The Code
Add the following Javascript file to your <head> section.
<script type="text/javascript" src="http://code.jquery.com/jquery-1.5.js"></script>
<script type="text/javascript" src="http://svcs.martindale.com/popupwidget/scripts/widget-1.0.js"></script>
Wherever you want a mini-profile widget popup to
appear, add a standard <a> tag to create a link on the name. The
name you choose to include in
the <a> tag isn't actually used to look up the profile. Instead we
require you to pass the ISLN number for the Attorney widget and the
ORG_ID for Organization widget via the javascript call as shown below:
<a class="callout" href="http://www.martindale.com/Donna-M-Sorrentino/24478989-lawyer.htm?provider_id=WIM" id="917940109" user="business" profile="Attorney" format="hover">Donna M. Sorrentino</a>
<a class="callout" href="http://www.lawyers.com/New-Jersey/New-Providence/Cooper-and-Smith-LLP-1110526-f.html?provider_id=WIP" id="909161" user="consumer" profile="Organization" format="hover">Cooper & Smith LLP</a>
Note that we are setting the value of user
attribute as "Attorney" and "Organization" respectively if you are
interested in a mini-profile widget based on ISLN and ORG_ID. If,
however, you are interested in getting a mini-profile widget based on
ALID and FLID, pass "AttorneyLocation" and "OrganizationLocation" string
respectively.
If you want the widget to appear when the user
clicks on the link, simply set the value for format attribute as
"click". Following table shows description of the various configurable attributes
that can be tailored to your liking -
Attribute
|
Description
|
| id |
Mandatory. Unique id assigned to Organization or Attorney. See section below the table on how to get this URL |
| user |
Optional. If your product is B2C, pass "consumer" else if its B2B pass "business". Its defaulted to consumer.
|
| format |
Mandatory. If you want the widget to appear onmousehover, pass "hover" else if you want it on onclick, pass "click"
|
| href |
Optional but highly recommended. This is the URL to the profile page on Lawyers.com or martindale.com. See section below the table on how to get this URL
|
profile
|
Mandatory.
For Attorney profile use ‘Attorney’ or for Organization profile use
‘Organization’. Alternatively use 'AttorneyLocation' or
'OrganizationLocation' for location specific profiles. |
| popuploc |
Optional. Depending on where on your website the anchor text is located, either on the left or right rail, we support popup of the widget on the right or the left of the text. By default this is set to "right".
|
How to get id and href attribute?
The next logical question in your mind would be -
This is all great but how do I get the profile URL and ORG_ID/FLID and
the ISLN/ALID number for a law firm and lawyer respectively? We have
built a ID look-up
tool where you can search for the firm or lawyer you are interested in
by name and in return you get back matching results with ORG_ID or ISLN
number along with the URL to their profile.
Error messages
If
you try to set a value for an attribute that is not supported by us,
your end users will see a friendly error message within the mini-profile
widget. For example, if you set the value of 'user' attribute to biz,
you will see a message looking like - "Incorrect 'user' attribute,
please pass the valid attribute".
Known Issues
None at this time