class CourseObjectBook in Course 6
Same name and namespace in other branches
- 7.2 modules/course_book/course_book.classes.inc \CourseObjectBook
- 7 modules/course_book/course_book.classes.inc \CourseObjectBook
Hierarchy
- class \CourseHandler
- class \CourseObject
- class \CourseObjectNode
- class \CourseObjectBook
- class \CourseObjectNode
- class \CourseObject
Expanded class hierarchy of CourseObjectBook
1 string reference to 'CourseObjectBook'
- course_book_course_handlers in modules/
course_book/ course_book.module - Implements hook_course_handlers().
File
- modules/
course_book/ course_book.classes.inc, line 3
View source
class CourseObjectBook extends CourseObjectNode {
function getNodeTypes() {
return array(
'book',
);
}
/**
* Make the book.
*/
public function create() {
$node = new stdClass();
$node->type = $this
->getComponent();
$node->title = $this
->getTitle();
$node->uid = $this->user->uid;
$node->book['bid'] = 'new';
node_save($node);
$this
->setNode($node);
}
function optionsDefinition() {
$defaults = parent::optionsDefinition();
$defaults['book_tracking'] = 'all';
$defaults['outline_list_item_type'] = 'active_tree';
return $defaults;
}
function optionsForm(&$form, &$form_state) {
$config = $this
->optionsDefinition();
parent::optionsForm($form, $form_state);
$form['book_tracking'] = array(
'#title' => t('Completion criteria'),
'#type' => 'select',
'#options' => array(
'one' => 'View any page',
'all' => 'View all pages',
),
'#default_value' => $config['book_tracking'],
);
// Add a book-specific configuration for course outline list item type, only
// if the standard course list outline handler is selected.
if ($this
->getCourse()
->getNode()->course['outline'] == 'course_outline_list') {
$form['outline_list_item_type'] = array(
'#title' => t('Course outline list item type'),
'#type' => 'select',
'#options' => array(
'all_pages' => t('All book pages as an expanded, nested list'),
'active_tree' => t('Only the active book menu tree items, with a count indicator'),
'count' => t('A count indicator only'),
),
'#default_value' => $config['outline_list_item_type'],
);
}
}
/**
* Grade (track) the book based on the fulfillment data.
*/
function grade() {
if (course_book_count($this->node->nid) == 0) {
// Book has no pages. Complete object.
$this
->getFulfillment()
->setComplete(1)
->save();
return;
}
if ($this
->getOption('book_tracking') == 'all') {
$mlids = array_keys(book_toc($this->node->nid, array(), 99));
$viewed = array_keys(array_filter($this
->getFulfillment()
->getOption('book_fulfillment')));
if (!array_diff($mlids, $viewed)) {
$this
->getFulfillment()
->setComplete(1)
->save();
}
}
elseif ($this
->getOption('book_tracking') == 'one') {
$this
->getFulfillment()
->setComplete(1)
->save();
}
}
/**
* Overrides navigation links.
*/
public function overrideNavigation() {
$links = parent::overrideNavigation();
$node = node_load(arg(1));
if (isset($node->book)) {
$book_link = $node->book;
if ($prev = book_prev($book_link)) {
$links['prev'] = l('Previous', $prev['href']);
}
if ($next = book_next($book_link)) {
$links['next'] = l('Next', $next['href']);
}
}
return $links;
}
/**
* Overrides a course outline list item.
*/
public function overrideOutlineListItem(&$item) {
// Check that course list outline handler is selected.
if ($this
->getCourse()
->getNode()->course['outline'] == 'course') {
$type = $this
->getOption('outline_list_item_type');
// Override the list item by reference.
course_book_override_outline_list_item($item, $this, $type);
}
}
public function getCloneAbility() {
return t('%title will only clone the first page.', array(
'%title' => $this
->getTitle(),
));
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
CourseHandler:: |
private | property | ||
CourseHandler:: |
protected | property | ||
CourseHandler:: |
public | property | ||
CourseHandler:: |
public | property | ||
CourseHandler:: |
public | property | ||
CourseHandler:: |
public | property | ||
CourseHandler:: |
final public | function | Merge an array of options onto the existing options. | |
CourseHandler:: |
public | function | Get an array of access messages. | |
CourseHandler:: |
protected | function | Return an array of database fields. This determines what fields should be serialized instead of stored. | |
CourseHandler:: |
function | |||
CourseHandler:: |
final public | function | Get an option stored in this CourseObject. | |
CourseHandler:: |
private | function | Merge arrays with replace, not append. | |
CourseHandler:: |
public | function | Set an access message to be displayed along with the course object when it is in the outline. For example, "This activity will open on XYZ" or "Please complete Step 1 to take this activity." | |
CourseHandler:: |
final public | function | Set an option for this handler. | |
CourseHandler:: |
final public | function | Set this entire handler's options. | |
CourseObject:: |
private | property | ||
CourseObject:: |
private | property | ||
CourseObject:: |
protected | property | ||
CourseObject:: |
public | function | Access functionality for course objects. | |
CourseObject:: |
function | Get the object component for this course object. | ||
CourseObject:: |
function | Get the Course that contains this CourseObject. | ||
CourseObject:: |
function | Get the course node ID this CourseObject belongs to. | ||
CourseObject:: |
public | function | Get this course object's fulfillment object. | |
CourseObject:: |
function | Get the instance ID. This could be the external component ID, a Node ID... | ||
CourseObject:: |
public static | function | Return the number of occurances that can be in a course at the same time. For example, the design of the Certificate module can only have 1 set of mappings per node. The same goes for Course Credit. We may also want a course object that can only be… | 2 |
CourseObject:: |
function | Get the module that provides this course object. | ||
CourseObject:: |
public | function |
Get options, with session options having precedence. Overrides CourseHandler:: |
|
CourseObject:: |
public | function |
Get core options summary. Overrides CourseHandler:: |
2 |
CourseObject:: |
function | Let the course object provide its own reports. | 4 | |
CourseObject:: |
function | Let the course object provide its own reports. | 4 | |
CourseObject:: |
public | function | Get the user's status in this course object. | 1 |
CourseObject:: |
function | |||
CourseObject:: |
public | function | Return the URL to the course object router. | |
CourseObject:: |
public | function | Specify whether fulfillment uses asynchronous polling. | 2 |
CourseObject:: |
public | function | ||
CourseObject:: |
function | Is this object graded? | 2 | |
CourseObject:: |
public | function | Is this course object required for course completion? | |
CourseObject:: |
function | Checks the temporary status of a course object. | ||
CourseObject:: |
private | function | ||
CourseObject:: |
function | Give the course object a chance do asynchronous polling and set completion on demand. | ||
CourseObject:: |
public | function | Get all course object implementations of getOptionsSummary(). | |
CourseObject:: |
function | Set the object component for this course object. | ||
CourseObject:: |
public | function | Set the Course for this CourseObject. | |
CourseObject:: |
function | Set the internal course object ID. | ||
CourseObject:: |
function | Set this object's instance ID. | ||
CourseObject:: |
function | Set the module that provides this course object. | ||
CourseObject:: |
function | Set the user fulfilling/creating this course object. | ||
CourseObject:: |
public | function | 5 | |
CourseObject:: |
final public | function | Take a course object. | |
CourseObject:: |
function | Remove any records associated with this course object for the user. | 1 | |
CourseObjectBook:: |
public | function |
Make the book. Overrides CourseObjectNode:: |
|
CourseObjectBook:: |
public | function |
Returns an translated error message if this object has issues with cloning. Overrides CourseObjectNode:: |
|
CourseObjectBook:: |
function |
Return a list of valid node types. Overrides CourseObjectNode:: |
||
CourseObjectBook:: |
function | Grade (track) the book based on the fulfillment data. | ||
CourseObjectBook:: |
function |
Define configuration elements and their defaults. Overrides CourseObjectNode:: |
||
CourseObjectBook:: |
function |
Default options form for all course objects. Overrides CourseObjectNode:: |
||
CourseObjectBook:: |
public | function |
Overrides navigation links. Overrides CourseObject:: |
|
CourseObjectBook:: |
public | function |
Overrides a course outline list item. Overrides CourseObject:: |
|
CourseObjectNode:: |
protected | property | ||
CourseObjectNode:: |
public | function |
Destroy the node instance. Overrides CourseObject:: |
|
CourseObjectNode:: |
function |
Freeze data to persist over cloning/exporting. Overrides CourseObject:: |
||
CourseObjectNode:: |
public | function |
Get the URL to edit this course object, if any. Overrides CourseObject:: |
|
CourseObjectNode:: |
public | function |
Simple node course object behavior is to just redirect to the node. Overrides CourseObject:: |
3 |
CourseObjectNode:: |
public | function |
Get the URL to take this course object, if any. Overrides CourseObject:: |
1 |
CourseObjectNode:: |
public | function |
Return a list of warning strings about this handler. Overrides CourseHandler:: |
2 |
CourseObjectNode:: |
function |
Grant access to course content before going to it. Overrides CourseObject:: |
||
CourseObjectNode:: |
public | function | ||
CourseObjectNode:: |
public | function |
Save object configs to cache. Overrides CourseObject:: |
2 |
CourseObjectNode:: |
public | function |
Validate the options form. Check the node type. Overrides CourseObject:: |
|
CourseObjectNode:: |
function |
Duration expired (or something) - CourseObject is telling us so. Overrides CourseObject:: |
||
CourseObjectNode:: |
function |
On object write, set privacy on this node. Overrides CourseObject:: |
||
CourseObjectNode:: |
public | function | Set the node and instance ID (node ID) of this CourseObjectNode. | |
CourseObjectNode:: |
function |
Thaw data frozen from an earlier export/clone. Overrides CourseObject:: |
3 | |
CourseObjectNode:: |
public | function |
Construct a course object from a database record. Overrides CourseObject:: |