james young » code example

MediaWiki Radius Authentication Extension – RadiusAuthPlugin

James Young — Thu, 18 Feb 2010 02:26:52 +0000

Here is an extension / plugin for mediawiki to authenticate against a Radius server. I couldn’t find one anywhere else, which is surprising. I can’t believe I am the first person to want to do this. Anyway, this is just bare bones, but it works for an internal mediawiki setup.

First, get Pure PHP radius class 1.2.2 from http://developer.sysco.ch/php. This does the actual radius authentication. Put radius.class.php in wiki/extensions/ (assuming wiki is your mediawiki install). There is probably a better place to put it, but I was setting this up for internal use and wanted to get it working quickly.

Next, create wiki/extensions/RadiusAuthPlugin.php. Make sure you fill in RADIUS_SERVER, SHARED_SECRET, and NAS_IP_ADDRESS with your actual information


require_once('AuthPlugin.php');
require_once('radius.class.php');
 
error_reporting(E_ALL);
 
class RadiusAuthPlugin extends AuthPlugin
{
    function userExists($username)
    {
        return TRUE;
    }
 
 
 
    function authenticate($username, $password)
    {
        $username = strtolower($username);
 
        $radius = new Radius('RADIUS_SERVER', 'SHARED_SECRET');
        $radius->SetNasIpAddress('NAS_IP_ADDRESS'); // Needed for some devices (not always auto-detected)
        if ($radius->AccessRequest($username, $password))
        {
            return TRUE;
        }
 
        return FALSE;
    }
 
 
 
    function modifyUITemplate(&$template)
    {
        $template->set('usedomain', FALSE);
        $template->set('useemail', FALSE);
        $template->set('create', FALSE);
    }
 
 
 
    function autoCreate()
    {
        return TRUE;
    }
 
 
 
    function validDomain($domain)
    {
        return TRUE;
    }
 
 
 
    function updateUser(&$user)
    {
        return TRUE;
    }
 
 
 
    function allowPasswordChange()
    {
        return FALSE;
    }
 
 
 
    function setPassword($password)
    {
        return FALSE;
    }
 
 
 
    function updateExternalDB($user)
    {
        return FALSE;
    }
 
 
    function canCreateAccounts()
    {
        return FALSE;
    }
 
 
    function adduser($user, $password)
    {
        return FALSE;
    }
 
 
 
    function strict()
    {
        return TRUE;
    }
 
 
 
    function initUser(&$user) { }
}
 
 
$wgExtensionCredits['other'][] = array(
    'name' => 'RadiusAuthPlugin',
    'version' => '1.0.0',
    'author' => 'James Young',
    'description' => 'Automatic login with a RADIUS server'
);

Lastly, put this in your LocalSetup.php:

require_once("./extensions/RadiusAuthPlugin.php");
$wgAuth = new RadiusAuthPlugin();
$wgGroupPermissions['*']['createaccount'] = false;

Example of an offline web app

James Young — Wed, 30 Dec 2009 16:54:25 +0000

The app: http://psyjinx.com/iphone/

This is a very simple webapp. It displays images that iPhones and iPod Touches can use as wallpaper. There isn’t really a need for offline use with the iPhone, but the iPod Touch could benefit from it. It took me about 10 minutes to learn what to do, and implement it for full offline use. The key to making a web app work offline is to add a manifest file.

The manifest file: I named mine page.manifest, but it can be anything.manifest. The first line must be CACHE MANIFEST

CACHE MANIFEST
 
# html
index.html
 
# images
wallpaper1.jpg
wallpaper2.jpg
wallpaper3.jpg 
wallpaper4.jpg
wallpaper6.jpg
wallpaper7.jpg
wallpaper8.jpg
background.png
favicon.ico

Add this to your html file:

The manifest file must be served as text/cache-manifest. Add this to your apache conf file in the mines section. My apache install had a mime.types file

text/cache-manifest    manifest

Restart apache and you are done

References:

Small JavaScript DateTimeTools object

James Young — Wed, 09 Sep 2009 23:58:03 +0000

So I got the project working on a tv schedule at work. As you can imagine there is work that needs to be done with dates and times when moving forward / back in the schedule. I found a few things out there that were full blown date/time js libraries, but they were a bit more than what I needed and didn’t do exactly what I needed. So I threw the following together. It does have specific stuff in it that is probably not portable to other projects, but here it is.

var dateTimeTools = (function ()
{
    var me = {};
 
    me.getMonthString = function (month)
    {
        var today = new Date();
        var montharray = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
        month = month || today.getMonth() + 1;
 
        return montharray[month - 1];
    };
 
    me.getWeekdayString = function (weekday)
    {
        var today = new Date();
        var dayarray = ['Sun.', 'Mon.', 'Tues.', 'Weds.', 'Thurs.', 'Fri.', 'Sat.'];
        weekday = weekday || today.getDay();
 
        return dayarray[weekday];
    };
 
 
    me.getDateString = function (theDate)
    {
        theDate = theDate || new Date();
        var year, month, date, weekday;
 
        // theDate can be either an instance of a Date object, or one of the custom date startDateTime objects used elsewhere
        if (theDate.hasOwnProperty('month'))
        {
            // dealing w/ a custom startDateTime object
            year = theDate.year;
            month = me.getMonthString(theDate.month);
            date = parseInt(theDate.date, 10);
            weekday = me.getWeekdayString(theDate.weekday);
        }
        else
        {
            // dealing w/ a JS Date object
            year = theDate.getFullYear();
            month = me.getMonthString(theDate.getMonth() + 1);
            date = theDate.getDate();
            weekday = me.getWeekdayString(theDate.getDay());
        }
 
        return weekday + ', ' + month + ' ' + date + ', ' + year;
    };
 
 
    me.getOffsetTime = function (startDateTime, offset)
    {
        offset = offset || 0;
 
        if (offset !== 0)
        {
            // this isn't going to be very portable, requires page.startDateTime object on page to work
            // returns a page.startDateTime object as well
            var datetime = new Date();
            datetime.setFullYear(
                    startDateTime.year,
                    parseInt(startDateTime.month, 10),
                    parseInt(startDateTime.date, 10)
            );
 
            datetime.setHours(
                    parseInt(startDateTime.hour, 10),
                    parseInt(startDateTime.minute, 10)
            );
 
            datetime.setHours(datetime.getHours() + offset);
 
            var month = datetime.getMonth();
            var date = datetime.getDate();
            var year = datetime.getFullYear();
            var hour = datetime.getHours();
            var minute = datetime.getMinutes();
 
            // pad everything w/ zeroes
            month = dateTimeTools.getPaddedMonth(month);
            date = dateTimeTools.getPaddedDate(date);
            hour = dateTimeTools.getPaddedHour(hour);
            minute = dateTimeTools.getPaddedMinute(minute);
            minute = minute < 30 ? '00' : '30';
 
            return {
                month : month,
                date : date,
                year : year,
                hour : hour,
                minute : minute,
                time : hour + ':' + minute + ':00'
            };
        }
 
        return startDateTime;
    };
 
 
    me.getPaddedDate = function (date)
    {
        var today = new Date();
        date = date.toString() || today.getDate();
 
        return date < 10 ? '0' + date : date;
    };
 
    me.getPaddedHour = function (hour)
    {
        var today = new Date();
        hour = hour.toString() || today.getHours();
 
        return hour < 10 ? '0' + hour : hour;
    };
 
    me.getPaddedMinute = function (minute)
    {
        var today = new Date();
        minute = minute.toString() || today.getMinutes();
 
        return minute < 10 ? '0' + minute : minute;
    };
 
    me.getPaddedMonth = function (month)
    {
        var today = new Date();
        month = month.toString() || today.getMonth() + 1;
 
        return month < 10 ? '0' + month : month;
    };
 
    me.getTwelveHourTime = function (hour, minute)
    {
        var today = new Date();
        hour = hour.toString() || today.getHours(); // using toString() since 0 will eval to false
        minute = minute.toString() || today.getMinutes();
 
        // manipulate the hour to account for midnight and noon
        var suffix = (hour >= 12 && hour < 24) ? 'PM' : 'AM';
        hour = hour >= 25 ? hour - 24 : hour;
        hour = hour === '0' ? 12 : hour;
 
        return hour > 12 ? (hour - 12) + ':' + minute + ' ' + suffix : hour + ':' + minute + ' ' + suffix;
    };
 
    return me;
}());

Ever need to iterate though all the members of an object (javascript)?

James Young — Wed, 09 Sep 2009 15:34:02 +0000

You know you have… if you are like me though, you can never remember the exact syntax. Here it is:

for (var name in object)
{
    if (object.hasOwnProperty(name))
    {
        alert(name + ': ' + object[name]);
    }
}

YUI DataTable – Using a dateCellEditor with an asyncSubmitter

James Young — Thu, 30 Jul 2009 03:02:26 +0000

If you are wondering what a dateCellEditor and asyncSubmitter are go check out http://developer.yahoo.com/yui/examples/datatable/dt_cellediting.html. See the last_login column? Click on that, you will get a cool calendar that pops up for you to change the date. Pretty handy. That Inline Cell Editing page touches on how to implement that, but it doesn’t cover the actual asyncSubmitter when using a dateCellEditor which is where I could have used a bit more information.

This example uses five files:

index.html – template for the page
javascript.js – javascript that powers the datatable
datatabledata.php – back end process that returns the data for the datatable in JSON format
update.php – back end process that updates the data in the database based on what the user changed

Below is a code example that spells it all out.

index.html


<html>
<head>
    <title>DataTable inline cell editing with dateCellEditor and asyncSubmitter example</title>
    <link rel="stylesheet" type="text/css" href="http://yui.yahooapis.com/2.7.0/build/reset-fonts-grids/reset-fonts-grids.css">
    <link rel="stylesheet" type="text/css" href="http://yui.yahooapis.com/2.7.0/build/base/base-min.css">
    <link rel="stylesheet" type="text/css" href="http://yui.yahooapis.com/2.7.0/build/datatable/assets/skins/sam/datatable.css">
    <link rel="stylesheet" type="text/css" href="http://yui.yahooapis.com/2.7.0/build/calendar/assets/skins/sam/calendar.css">
</head>
 
<body class='yui-skin-sam'>
    <div id="datatable"></div>
    <script src="http://yui.yahooapis.com/2.7.0/build/yahoo-dom-event/yahoo-dom-event.js"></script>
    <script src="http://yui.yahooapis.com/2.7.0/build/connection/connection-min.js"></script>
    <script src="http://yui.yahooapis.com/2.7.0/build/calendar/calendar-min.js"></script>
    <script src="http://yui.yahooapis.com/2.7.0/build/json/json-min.js"></script>
    <script src="http://yui.yahooapis.com/2.7.0/build/element/element-min.js"></script>
    <script src="http://yui.yahooapis.com/2.7.0/build/datasource/datasource-min.js"></script>
    <script src="http://yui.yahooapis.com/2.7.0/build/datatable/datatable-min.js"></script>
    <script src="javascript.js"></script>
</body>
</html>

javascript.js

var STWPT = YAHOO.namespace("stwpt");
 
STWPT.init = function ()
{
    STWPT.getDataTableData();
};
 
STWPT.getDataTableData = function ()
{
    var submitter = function (callback, newValue)
    {
        var record = this.getRecord();
        var column = this.getColumn();
        var oldValue = this.value;
        var datatable = this.getDataTable();
 
        // send the data to our update page to update the value in the database
        YAHOO.util.Connect.asyncRequest('POST', 'update.php',
        {
            success: function (o)
            {
                var r = YAHOO.lang.JSON.parse(o.responseText);
 
                if (r.replyType === 'date') { r.data = YAHOO.util.DataSource.parseDate(r.data); }
 
                if (r.replyCode === '201') { callback(true, r.data); }
                else
                {
                    alert(r.replyText);
                    callback();
                }
            },
            failure: function (o)
            {
                alert(o.statusText);
                callback();
            },
            scope: this
        },
        'action=cellEdit&column=' + column.key +
                     '&newValue=' + escape(newValue) +
                     '&oldValue=' + escape(oldValue) +
                      '&team_id=' + record.getData('team_id') +
                     '&type=team'
        );
    };
 
    var textEditor = new YAHOO.widget.TextboxCellEditor({ disableBtns: false, asyncSubmitter: submitter });
 
    var myColumnDefs = [
        { key: 'team_id', label: 'Id', hidden: true },
        { key: 'name', label: 'Team Name', sortable: true, resizeable: true, editor: textEditor },
        { key: 'start_date', label: 'Start Date', sortable: true, resizeable: true, editor: new YAHOO.widget.DateCellEditor({ asyncSubmitter: submitter }), formatter: YAHOO.widget.DataTable.formatDate
        { key: 'end_date', label: 'End Date', sortable: true, resizeable: true, editor: new YAHOO.widget.DateCellEditor({ asyncSubmitter: submitter }), formatter: YAHOO.widget.DataTable.formatDate }
    ];
 
    var myDataSource = new YAHOO.util.DataSource('datatabledata.php');
    myDataSource.responseType = YAHOO.util.DataSource.TYPE_JSON;
    myDataSource.connXhrMode = 'queueRequests';
    myDataSource.connMethodPost = true;
    myDataSource.responseSchema = {
        resultsList: 'teams',
        fields: ['team_id', 'name', { key: 'start_date', parser: 'date' }, { key: 'end_date', parser: 'date' }]
    };
 
    var myDataTable = new YAHOO.widget.DataTable('datatable', myColumnDefs, myDataSource);
 
    var onCellClick = function (oArgs) { this.onEventShowCellEditor(oArgs); };
 
    myDataTable.subscribe('cellClickEvent', onCellClick);
 
    var mySuccessHandler = function () {
       this.onDataReturnAppendRows.apply(this, arguments);
    };
 
    var myFailureHandler = function () { alert('FAIL'); };
 
    var callback = {
        success: mySuccessHandler,
        failure: myFailureHandler,
        scope: myDataTable
    };
 
};
 
YAHOO.util.Event.onDOMReady(STWPT.init);

datatabledata.php


// NOTE: if this wasn't an example, this would be done in CodeIgniter
mysql_pconnect('localhost', 'msyql_username', 'mysql_password');
mysql_select_db('mysql_database_name');
 
$user_id = 1;      // hardcoded for this example
$facility_id = 1;  // hardcoded for this example
 
$teams = array();
 
$sql = "SELECT t.id AS team_id,
               t.name,
               t.datatable_key,
               DATE_FORMAT(t.start_date, '%m/%d/%Y') AS start_date,
               DATE_FORMAT(t.end_date, '%m/%d/%Y') AS end_date
          FROM teams AS t,
               user_facility_teams AS uft
         WHERE uft.user_id = {$user_id}
           AND uft.facility_id = {$facility_id}
           AND t.id = uft.team_id
";
 
$result = mysql_query($sql);
 
while ($row = mysql_fetch_array($result))
{
    array_push($teams, $row);
}
 
$response = '{"teams" : ';
$response .= json_encode($teams);
$response .= '}';
 
echo $response;

update.php


// NOTE: if this wasn't an example, this would be done in CodeIgniter
mysql_pconnect('localhost', 'msyql_username', 'mysql_password');
mysql_select_db('mysql_database_name');
 
$user_id = 1;      // hardcoded for this example
$facility_id = 1;  // hardcoded for this example
 
$data['column'] = $_POST['column'];
$data['value'] = trim($_POST['newValue']);
$data['team_id'] = $_POST['team_id'];
 
 
$json_response_value = $data['value'];
 
foreach ($data as $key => $value) { $data[$key] = mysql_real_escape_string($data[$key]); }
 
// if we are changing the 'name' we must also update the key used for datatable column definitions
$set_datatable_key = '';
if ($data['column'] == 'name')
{
    $datatable_key = preg_replace('/[ -]/', '_', $data['value']);
    $datatable_key = preg_replace('/%/', 'percent', $datatable_key);
    $datatable_key = strtolower($datatable_key);
 
    $set_datatable_key = ", datatable_key = '{$datatable_key}'";
 
    $sql = "UPDATE teams
               SET {$data['column']} = '{$data['value']}' {$set_datatable_key}
             WHERE id = {$data['team_id']}
    ";
 
    $replyType = 'string';
}
 
if ($data['column'] == 'start_date' || $data['column'] == 'end_date')
{
    $sql = "UPDATE teams
               SET {$data['column']} = STR_TO_DATE('{$data['value']}', '%a %b %d %Y')
             WHERE id = {$data['team_id']}
    ";
 
    $replyType = 'date';
}
 
$result = mysql_query($sql);
 
$response = array('replyCode' => '201', 'replyText' => 'Ok', 'replyType' => $replyType, 'data' => $json_response_value);
 
echo json_encode($response);

YUI Datatable – Custom Parser Example

James Young — Sun, 24 May 2009 01:40:03 +0000

For entry, with my validator, I am validating that no matter what a user types in for a height, I convert it to a float to store in the database (5.10). In retrospect, I should convert it to the inches value, but this example isn’t doing that.

For display, with my formatter, I am standardizing the format to display as a proper height (5′ 10″).

All that is left is to get the column sort to not think someone that is 22′ tall is shorter than someone that is 3′ tall. For numbers to sort numerically, the type must be a Number, not a String. This could be easily accomplished with YAHOO.widget.DataTable.formatNumber, but I was hoping to be able to fix my problem of 5.10 changing to 5.1 here. I was not able to do that, as you can see by the commented out line below, so I took care of it in the validator (kinda).

Due to the lack of me finding, quickly, an example of a custom parser, I am posting this anyway, even though it is not really needed.

The parser is an object property defined in the array of objects defining the fields for the datasources responseSchema (assuming JSON).

STWPT.parseHeight = function (oData)
{
    oData = parseFloat(oData);    // convert to number (float)
 
    // force decimal precision (5.1 > 5.10)
    // this converts it back to a string
    // oData = oData.toFixed(2);     
 
    return oData;
}

The following is a snippet out of a larger script that shows just the pieces that connect the datatable creation to the custom parser shown above.

var myDataSource = new YAHOO.util.DataSource('/path/to/datasource');
myDataSource.responseType = YAHOO.util.DataSource.TYPE_JSON;
myDataSource.connMethodPost = true;
myDataSource.responseSchema = {
    resultsList: 'athletes',
    fields: [
        { key: 'first_name', parser: 'string' },
        { key: 'last_name', parser: 'string' },
        { key: 'height', parser: STWPT.parseHeight }
    ]
};
 
var myDataTable = new YAHOO.widget.DataTable('athletes-datatable', myColumnDefs, myDataSource);

YUI Datatable – Custom Validator Example

James Young — Sun, 24 May 2009 01:37:12 +0000

This is the validator I am using to insure that a height (or float) was entered (5’10″, 5′ 10″, 5.10 5 10), and that text (tall, short) was not entered and covert a valid non-float value entered (5’10″, 5′ 10″, 5 10) to a float (5.10), which is how I want to store the value in the database for this example.

Now that we have a custom validator created, it would be helpful to know where to call it from. A validator is an object parameter to the object that is sent to a textboxCellEditor.

The textboxCellEditor is an object parameter to the object that defines the column, in the array of objects that is sent to the datatable constructor.

STWPT.validateHeight = function (oData)
{
    var pattern; // regexp pattern holder
 
    // heightFormat is expected to be a decimal number for height
 
    // add a space if none was provided (5'10")
    // 5'10" -> 5' 10 - note the trailing non-digit characters are dropped
    pattern = /'(\d+)/g
    if (pattern.test(oData)) { oData = oData.replace(pattern, " $1"); }
 
    // turn a space into a decimal - 5 10, 5' 10" -> 5.10, 5' 10"
    pattern = / /g;
    if (pattern.test(oData)) { oData = oData.replace(pattern, '.'); }
 
    // remove all single and double quotes - 5' 10", 5'.10" -> 5.10
    pattern = /["']/g
    if (pattern.test(oData)) { oData = oData.replace(pattern, ''); }
 
    // enforce x.0x format - 5' 1" -> 5' 01" -> 5.01
    pattern = /\.([1-9])$/
    if (pattern.test(oData)) { oData = oData.replace(pattern, '.0$1')};
 
    // at this point we should have a float, which should eval > 0
 
    if (oData > 0) { return oData; }
 
    // validation only succeeds if a value is returned
}

The following is a snippet out of a larger script that shows just the pieces that connect the datatable creation to the custom validator shown above.

var heightEditor = new YAHOO.widget.TextboxCellEditor({
    disableBtns: false,
    asyncSubmitter: submitter,
    validator: STWPT.validateHeight
});
 
var myColumnDefs = [{
    key: 'height',
    label: 'Height',
    sortable: true,
    resizeable: true,
    editor: heightEditor,
    formatter: STWPT.formatHeight
}];
 
var myDataTable = new YAHOO.widget.DataTable('athletes-datatable', myColumnDefs, myDataSource);

YUI Datatable – Custom Formatter Example

James Young — Sun, 24 May 2009 01:29:35 +0000

I needed to create a custom formatter for a datatable that contained a cell for an individuals height. The height is stored in the database as a float. 5′ 10″ would be in the database as 5.10. In retrospect I should be storing the height as inches and converting it to feet as needed. We want to display 5′ 10″, this is where our custom formatter comes in.

The formatter is an object property to the column definition in the array of objects that is sent to the datable when it is created.

STWPT.formatHeight = function (elCell, oRecord, oColumn, oData)
{
    oData = oData.toString(); // oData must be a string
    var part = oData.split('.'); // splitting the float on the decimal
 
    // take care of undefined - set it to 0
    // if we have an int (like 5, not 5.1), part[1] is 'undefined'
    part[1] = part[1] ? part[1] : 0;
 
    // values like 5.10 are changed to 5.1
    // if textboxCellEditor is used, 5.1 will show as the value (not 5.10)
    if (part[1] == '1') { part[1] = '10'; }
 
    elCell.innerHTML = part[0] + '\' ' + part[1] + '"';
}

The following is a snippet out of a larger script that shows just the pieces that connect the datatable creation to the custom formatter shown above.

var myColumnDefs = [{
    key: 'height',
    label: 'Height',
    sortable: true,
    resizeable: true,
    editor: heightEditor,
    formatter: STWPT.formatHeight
}];
 
var myDataTable = new YAHOO.widget.DataTable('athletes-datatable', myColumnDefs, myDataSource);