PHP - MENU_LOCAL_TASK in Drupal

Question

How do I add #markup or #suffix to MENU_LOCAL_TASK in Drupal?

$items['user/%/checkins_history'] = array( //add to to user's profile
            'type' => MENU_LOCAL_TASK,
            'title' => t('Checkins History'),           
            'suffix' => '<div>Num'.$num_of_results .'</div>', // NOT WORKING            
            'access arguments' => array('Administer Checkins'),
            'page arguments' => array(1),
            'file' => 'manager.inc',
            'page callback' => 'manager_checkins_history_page'
        );

Answer 1

What you're asking doesn't really make sense.

MENU_LOCAL_TASK is used as metadata for a route defined in hook_menu().

#prefix and #suffix are properties for render arrays.

The two concepts are not compatible.

Answer 2

Your calling this from hook_menu, correct? I don't believe that suffix can be used from here. At least it's not in the list of valid return values in listed on the hook_menu page.

You'll need to add the suffix to whatever the output of your url is, if it's a form, it can nicely be added to the form via the form api.

Example:

Let's say your function manager_checkins_history_page is a form that uses the form aip, and looks something like this:

function manager_checkins_history_page($form, &$form_state){

  $form['switch'] = array(
    '#type' => 'checkbox',
    '#title' => t('i'm a chekcbox'),
    '#default_value' => false,
  );

  $form['submit'] = array(
    '#type' => 'submit',
    '#value' => t('Submit'),
  );

  return $form;
}

if you wanted to apply a suffix to the whole form, you could do something like:

function manager_checkins_history_page($form, &$form_state){
  $form['group1'] = array(
    '#type' => 'fieldset',
    '#title' => t('Your Name'),
    '#suffix' => "I'm a suffix for your form",  
   );

  $form['group1']['switch'] = array(
    '#type' => 'checkbox',
    '#title' => t('i'm a chekcbox'),
    '#default_value' => false,
  );

  $form['group1']['submit'] = array(
    '#type' => 'submit',
    '#value' => t('Submit'),
  );

  return $form;
}

That would give you a form, wrapped in a box, with a suffix at the end.