On block configuration page we can control the display of the block on three factors: 1. All pages except those listed 2. Only the listed pages 3. Pages on which this PHP code returns TRUE (experts only)
how can it be done programatically in my module file?
i solved it by giving configuration in hook_block_info function
function hook_block_info(){
$blocks = array();
$blocks['appendices_page_options'] = array(
'info' => t('Appendices Page Options'),
'status' => TRUE,
'theme' => 'MY_THEME',
'region' => 'MY_REGION',
'weight' => 0,
'visibility' => 1,
'pages' => "aboutus/*",
'custom' => FALSE
);
return $blocks;
}
Take a look at block_add_block_form_submit in modules/block/block.admin.inc. This is the regular block creation form; it appears to just insert the records directly rather than calling another function. Note that each record in the block table is linked to a single theme (you can just use the active one but it's safer to insert records for all themes). The block_custom table holds the content.
Note the 'visibility' value being set at line 569. This is where you would set the display settings you're inquiring about.
