course/format/renderer.php

   1 <?php
   2 // This file is part of Moodle - http://moodle.org/
   3 //
   4 // Moodle is free software: you can redistribute it and/or modify
   5 // it under the terms of the GNU General Public License as published by
   6 // the Free Software Foundation, either version 3 of the License, or
   7 // (at your option) any later version.
   8 //
   9 // Moodle is distributed in the hope that it will be useful,
  10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 // GNU General Public License for more details.
  13 //
  14 // You should have received a copy of the GNU General Public License
  15 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
  16
  17 /**
  18  * Base renderer for outputting course formats.
  19  *
  20  * @package core
  21  * @copyright 2012 Dan Poltawski
  22  * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  23  * @since Moodle 2.3
  24  */
  25
  26 defined('MOODLE_INTERNAL') || die();
  27
  28
  29 /**
  30  * This is a convenience renderer which can be used by section based formats
  31  * to reduce code duplication. It is not necessary for all course formats to
  32  * use this and its likely to change in future releases.
  33  *
  34  * @package core
  35  * @copyright 2012 Dan Poltawski
  36  * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  37  * @since Moodle 2.3
  38  */
  39 abstract class format_section_renderer_base extends plugin_renderer_base {
  40
  41     /**
  42      * Generate the starting container html for a list of sections
  43      * @return string HTML to output.
  44      */
  45     abstract protected function start_section_list();
  46
  47     /**
  48      * Generate the closing container html for a list of sections
  49      * @return string HTML to output.
  50      */
  51     abstract protected function end_section_list();
  52
  53     /**
  54      * Generate the title for this section page
  55      * @return string the page title
  56      */
  57     abstract protected function page_title();
  58
  59     /**
  60      * Generate the content to displayed on the right part of a section
  61      * before course modules are included
  62      *
  63      * @param stdClass $section The course_section entry from DB
  64      * @param stdClass $course The course entry from DB
  65      * @param bool $onsectionpage true if being printed on a section page
  66      * @return string HTML to output.
  67      */
  68     protected function section_right_content($section, $course, $onsectionpage) {
  69         $o = $this->output->spacer();
  70
  71         if ($section->section != 0) {
  72             $controls = $this->section_edit_controls($course, $section, $onsectionpage);
  73             if (!empty($controls)) {
  74                 $o = implode('<br />', $controls);
  75             }
  76         }
  77
  78         return $o;
  79     }
  80
  81     /**
  82      * Generate the content to displayed on the left part of a section
  83      * before course modules are included
  84      *
  85      * @param stdClass $section The course_section entry from DB
  86      * @param stdClass $course The course entry from DB
  87      * @param bool $onsectionpage true if being printed on a section page
  88      * @return string HTML to output.
  89      */
  90     protected function section_left_content($section, $course, $onsectionpage) {
  91         $o = $this->output->spacer();
  92
  93         if ($section->section != 0) {
  94             // Only in the non-general sections.
  95             if ($course->marker == $section->section) {
  96                 $o = get_accesshide(get_string('currentsection', 'format_'.$course->format));
  97             }
  98         }
  99
 100         return $o;
 101     }
 102
 103     /**
 104      * Generate the display of the header part of a section before
 105      * course modules are included
 106      *
 107      * @param stdClass $section The course_section entry from DB
 108      * @param stdClass $course The course entry from DB
 109      * @param bool $onsectionpage true if being printed on a section page
 110      * @return string HTML to output.
 111      */
 112     protected function section_header($section, $course, $onsectionpage) {
 113         global $PAGE;
 114
 115         $o = '';
 116         $currenttext = '';
 117         $sectionstyle = '';
 118         $linktitle = false;
 119
 120         if ($section->section != 0) {
 121             // Only in the non-general sections.
 122             if (!$section->visible) {
 123                 $sectionstyle = ' hidden';
 124             } else if ($course->marker == $section->section) {
 125                 $sectionstyle = ' current';
 126             }
 127             $linktitle = ($course->coursedisplay == COURSE_DISPLAY_MULTIPAGE);
 128         }
 129
 130         $o.= html_writer::start_tag('li', array('id' => 'section-'.$section->section,
 131             'class' => 'section main clearfix'.$sectionstyle));
 132
 133         $leftcontent = $this->section_left_content($section, $course, $onsectionpage);
 134         $o.= html_writer::tag('div', $leftcontent, array('class' => 'left side'));
 135
 136         $rightcontent = $this->section_right_content($section, $course, $onsectionpage);
 137         $o.= html_writer::tag('div', $rightcontent, array('class' => 'right side'));
 138         $o.= html_writer::start_tag('div', array('class' => 'content'));
 139
 140         if (!$onsectionpage) {
 141             $title = get_section_name($course, $section);
 142             if ($linktitle) {
 143                 $title = html_writer::link(course_get_url($course, $section->section), $title);
 144             }
 145             $o.= $this->output->heading($title, 3, 'sectionname');
 146         }
 147
 148         $o.= html_writer::start_tag('div', array('class' => 'summary'));
 149         $o.= $this->format_summary_text($section);
 150
 151         $context = context_course::instance($course->id);
 152         if ($PAGE->user_is_editing() && has_capability('moodle/course:update', $context)) {
 153             $url = new moodle_url('/course/editsection.php', array('id'=>$section->id));
 154
 155             if ($onsectionpage) {
 156                 $url->param('sectionreturn', 1);
 157             }
 158
 159             $o.= html_writer::link($url,
 160                 html_writer::empty_tag('img', array('src' => $this->output->pix_url('t/edit'), 'class' => 'iconsmall edit')),
 161                 array('title' => get_string('editsummary')));
 162         }
 163         $o.= html_writer::end_tag('div');
 164
 165         $o .= $this->section_availability_message($section);
 166
 167         return $o;
 168     }
 169
 170     /**
 171      * Generate the display of the footer part of a section
 172      *
 173      * @return string HTML to output.
 174      */
 175     protected function section_footer() {
 176         $o = html_writer::end_tag('div');
 177         $o.= html_writer::end_tag('li');
 178
 179         return $o;
 180     }
 181
 182     /**
 183      * Generate the edit controls of a section
 184      *
 185      * @param stdClass $course The course entry from DB
 186      * @param stdClass $section The course_section entry from DB
 187      * @param bool $onsectionpage true if being printed on a section page
 188      * @return array of links with edit controls
 189      */
 190     protected function section_edit_controls($course, $section, $onsectionpage = false) {
 191         global $PAGE;
 192
 193         if (!$PAGE->user_is_editing()) {
 194             return array();
 195         }
 196
 197         if (!has_capability('moodle/course:update', context_course::instance($course->id))) {
 198             return array();
 199         }
 200
 201         if ($onsectionpage) {
 202             $baseurl = course_get_url($course, $section->section);
 203         } else {
 204             $baseurl = course_get_url($course);
 205         }
 206         $baseurl->param('sesskey', sesskey());
 207
 208         $controls = array();
 209
 210         $url = clone($baseurl);
 211         if ($section->visible) { // Show the hide/show eye.
 212             $strhidefromothers = get_string('hidefromothers', 'format_'.$course->format);
 213             $url->param('hide', $section->section);
 214             $controls[] = html_writer::link($url,
 215                 html_writer::empty_tag('img', array('src' => $this->output->pix_url('i/hide'),
 216                 'class' => 'icon hide', 'alt' => $strhidefromothers)),
 217                 array('title' => $strhidefromothers, 'class' => 'editing_showhide'));
 218         } else {
 219             $strshowfromothers = get_string('showfromothers', 'format_'.$course->format);
 220             $url->param('show',  $section->section);
 221             $controls[] = html_writer::link($url,
 222                 html_writer::empty_tag('img', array('src' => $this->output->pix_url('i/show'),
 223                 'class' => 'icon hide', 'alt' => $strshowfromothers)),
 224                 array('title' => $strshowfromothers, 'class' => 'editing_showhide'));
 225         }
 226
 227         if (!$onsectionpage) {
 228             $url = clone($baseurl);
 229             if ($section->section > 1) { // Add a arrow to move section up.
 230                 $url->param('section', $section->section);
 231                 $url->param('move', -1);
 232                 $strmoveup = get_string('moveup');
 233
 234                 $controls[] = html_writer::link($url,
 235                     html_writer::empty_tag('img', array('src' => $this->output->pix_url('t/up'),
 236                     'class' => 'icon up', 'alt' => $strmoveup)),
 237                     array('title' => $strmoveup, 'class' => 'moveup'));
 238             }
 239
 240             $url = clone($baseurl);
 241             if ($section->section < $course->numsections) { // Add a arrow to move section down.
 242                 $url->param('section', $section->section);
 243                 $url->param('move', 1);
 244                 $strmovedown =  get_string('movedown');
 245
 246                 $controls[] = html_writer::link($url,
 247                     html_writer::empty_tag('img', array('src' => $this->output->pix_url('t/down'),
 248                     'class' => 'icon down', 'alt' => $strmovedown)),
 249                     array('title' => $strmovedown, 'class' => 'movedown'));
 250             }
 251         }
 252
 253         return $controls;
 254     }
 255
 256     /**
 257      * Generate a summary of a section for display on the 'coruse index page'
 258      *
 259      * @param stdClass $section The course_section entry from DB
 260      * @param stdClass $course The course entry from DB
 261      * @return string HTML to output.
 262      */
 263     protected function section_summary($section, $course) {
 264
 265         $o = '';
 266         $o.= html_writer::start_tag('li', array('id' => 'section-'.$section->section,
 267             'class' => 'section-summary clearfix'));
 268
 269         $title = get_section_name($course, $section);
 270         $o.= html_writer::start_tag('a', array('href' => course_get_url($course, $section->section)));
 271         $o.= $this->output->heading($title, 3, 'header section-title');
 272         $o.= html_writer::end_tag('a');
 273
 274         $o.= html_writer::start_tag('div', array('class' => 'summarytext'));
 275         $o.= $this->format_summary_text($section);
 276         $o.= html_writer::end_tag('div');
 277
 278         $o .= $this->section_availability_message($section);
 279
 280         $o.= html_writer::end_tag('li');
 281
 282         return $o;
 283     }
 284
 285     /**
 286      * If section is not visible to current user, display the message about that
 287      * ('Not available until...', that sort of thing). Otherwise, returns blank.
 288      *
 289      * @param stdClass $section The course_section entry from DB
 290      * @return string HTML to output
 291      */
 292     protected function section_availability_message($section) {
 293         $o = '';
 294         if (!$section->uservisible) {
 295             $o .= html_writer::start_tag('div', array('class' => 'availabilityinfo'));
 296             if (!empty($section->availableinfo)) {
 297                 $o .= $section->availableinfo;
 298             } else {
 299                 $o .= get_string('notavailable');
 300             }
 301             $o .= html_writer::end_tag('div');
 302         }
 303         return $o;
 304     }
 305
 306     /**
 307      * Show if something is on on the course clipboard (moving around)
 308      *
 309      * @param stdClass $course The course entry from DB
 310      * @param int $sectionno The section number in the coruse which is being dsiplayed
 311      * @return string HTML to output.
 312      */
 313     protected function course_activity_clipboard($course, $sectionno = 0) {
 314         global $USER;
 315
 316         $o = '';
 317         // If currently moving a file then show the current clipboard.
 318         if (ismoving($course->id)) {
 319             $url = new moodle_url('/course/mod.php',
 320                 array('sesskey' => sesskey(),
 321                       'cancelcopy' => true,
 322                       'sr' => $sectionno,
 323                 )
 324             );
 325
 326             $strcancel= get_string('cancel');
 327
 328             $o.= html_writer::start_tag('li', array('class' => 'clipboard'));
 329             $o.= strip_tags(get_string('activityclipboard', '', $USER->activitycopyname));
 330             $o.= ' ('.html_writer::link($url, get_string('cancel')).')';
 331             $o.= html_writer::end_tag('li');
 332         }
 333
 334         return $o;
 335     }
 336
 337     /**
 338      * Generate next/previous section links for naviation
 339      *
 340      * @param stdClass $course The course entry from DB
 341      * @param array $sections The course_sections entries from the DB
 342      * @param int $sectionno The section number in the coruse which is being dsiplayed
 343      * @return array associative array with previous and next section link
 344      */
 345     protected function get_nav_links($course, $sections, $sectionno) {
 346         // FIXME: This is really evil and should by using the navigation API.
 347         $canviewhidden = has_capability('moodle/course:viewhiddensections', context_course::instance($course->id))
 348             or !$course->hiddensections;
 349
 350         $links = array('previous' => '', 'next' => '');
 351         $back = $sectionno - 1;
 352         while ($back > 0 and empty($links['previous'])) {
 353             if ($canviewhidden || $sections[$back]->visible) {
 354                 $previouslink = html_writer::tag('span', $this->output->larrow(), array('class' => 'larrow'));
 355                 $previouslink .= get_section_name($course, $sections[$back]);
 356                 $links['previous'] = html_writer::link(course_get_url($course, $back), $previouslink);
 357             }
 358             $back--;
 359         }
 360
 361         $forward = $sectionno + 1;
 362         while ($forward <= $course->numsections and empty($links['next'])) {
 363             if ($canviewhidden || $sections[$forward]->visible) {
 364                 $nextlink = get_section_name($course, $sections[$forward]);
 365                 $nextlink .= html_writer::tag('span', $this->output->rarrow(), array('class' => 'rarrow'));
 366                 $links['next'] = html_writer::link(course_get_url($course, $forward), $nextlink);
 367             }
 368             $forward++;
 369         }
 370
 371         return $links;
 372     }
 373
 374     /**
 375      * Generate the header html of a stealth section
 376      *
 377      * @param int $sectionno The section number in the coruse which is being dsiplayed
 378      * @return string HTML to output.
 379      */
 380     protected function stealth_section_header($sectionno) {
 381         $o = '';
 382         $o.= html_writer::start_tag('li', array('id' => 'section-'.$sectionno, 'class' => 'section main clearfix orphaned hidden'));
 383         $o.= html_writer::tag('div', '', array('class' => 'left side'));
 384         $o.= html_writer::tag('div', '', array('class' => 'right side'));
 385         $o.= html_writer::start_tag('div', array('class' => 'content'));
 386         $o.= $this->output->heading(get_string('orphanedactivities'), 3, 'sectionname');
 387         return $o;
 388     }
 389
 390     /**
 391      * Generate footer html of a stealth section
 392      *
 393      * @return string HTML to output.
 394      */
 395     protected function stealth_section_footer() {
 396         $o = html_writer::end_tag('div');
 397         $o.= html_writer::end_tag('li');
 398         return $o;
 399     }
 400
 401     /**
 402      * Generate the html for a hidden section
 403      *
 404      * @param int $sectionno The section number in the coruse which is being dsiplayed
 405      * @return string HTML to output.
 406      */
 407     protected function section_hidden($sectionno) {
 408         $o = '';
 409         $o.= html_writer::start_tag('li', array('id' => 'section-'.$sectionno, 'class' => 'section main clearfix hidden'));
 410         $o.= html_writer::tag('div', '', array('class' => 'left side'));
 411         $o.= html_writer::tag('div', '', array('class' => 'right side'));
 412         $o.= html_writer::start_tag('div', array('class' => 'content'));
 413         $o.= get_string('notavailable');
 414         $o.= html_writer::end_tag('div');
 415         $o.= html_writer::end_tag('li');
 416         return $o;
 417     }
 418
 419     /**
 420      * Output the html for a single section page .
 421      *
 422      * @param stdClass $course The course entry from DB
 423      * @param array $sections The course_sections entries from the DB
 424      * @param array $mods used for print_section()
 425      * @param array $modnames used for print_section()
 426      * @param array $modnamesused used for print_section()
 427      * @param int $displaysection The section number in the course which is being displayed
 428      */
 429     public function print_single_section_page($course, $sections, $mods, $modnames, $modnamesused, $displaysection) {
 430         global $PAGE;
 431
 432         // Can we view the section in question?
 433         $context = context_course::instance($course->id);
 434         $canviewhidden = has_capability('moodle/course:viewhiddensections', $context);
 435
 436         if (!isset($sections[$displaysection])) {
 437             // This section doesn't exist
 438             print_error('unknowncoursesection', 'error', null, $course->fullname);
 439             return;
 440         }
 441
 442         if (!$sections[$displaysection]->visible && !$canviewhidden) {
 443             if (!$course->hiddensections) {
 444                 echo $this->start_section_list();
 445                 echo $this->section_hidden($displaysection);
 446                 echo $this->end_section_list();
 447                 echo $sectionnavlinks;
 448             }
 449             // Can't view this section.
 450             return;
 451         }
 452
 453         // General section if non-empty.
 454         $thissection = $sections[0];
 455         if ($thissection->summary or $thissection->sequence or $PAGE->user_is_editing()) {
 456             echo $this->start_section_list();
 457             echo $this->section_header($thissection, $course, true);
 458             print_section($course, $thissection, $mods, $modnamesused, true);
 459             if ($PAGE->user_is_editing()) {
 460                 print_section_add_menus($course, 0, $modnames);
 461             }
 462             echo $this->section_footer();
 463             echo $this->end_section_list();
 464         }
 465
 466         // Title with section navigation links.
 467         $sectionnavlinks = $this->get_nav_links($course, $sections, $displaysection);
 468         $sectiontitle = '';
 469         $sectiontitle .= html_writer::start_tag('div', array('class' => 'section-navigation headingblock header'));
 470         $sectiontitle .= html_writer::tag('span', $sectionnavlinks['previous'], array('class' => 'mdl-left'));
 471         $sectiontitle .= html_writer::tag('span', $sectionnavlinks['next'], array('class' => 'mdl-right'));
 472         $sectiontitle .= html_writer::tag('div', get_section_name($course, $sections[$displaysection]), array('class' => 'mdl-align'));
 473         $sectiontitle .= html_writer::end_tag('div');
 474         echo $sectiontitle;
 475
 476         // Show completion help icon.
 477         $completioninfo = new completion_info($course);
 478         echo $completioninfo->display_help_icon();
 479
 480         // Copy activity clipboard..
 481         echo $this->course_activity_clipboard($course, $displaysection);
 482
 483         // Now the list of sections..
 484         echo $this->start_section_list();
 485
 486         // The requested section page.
 487         $thissection = $sections[$displaysection];
 488         echo $this->section_header($thissection, $course, true);
 489         print_section($course, $thissection, $mods, $modnamesused, true);
 490         if ($PAGE->user_is_editing()) {
 491             print_section_add_menus($course, $displaysection, $modnames);
 492         }
 493         echo $this->section_footer();
 494         echo $this->end_section_list();
 495
 496         // Display section bottom navigation.
 497         $courselink = html_writer::link(course_get_url($course), get_string('returntomaincoursepage'));
 498         $sectionbottomnav = '';
 499         $sectionbottomnav .= html_writer::start_tag('div', array('class' => 'section-navigation mdl-bottom'));
 500         $sectionbottomnav .= html_writer::tag('span', $sectionnavlinks['previous'], array('class' => 'mdl-left'));
 501         $sectionbottomnav .= html_writer::tag('span', $sectionnavlinks['next'], array('class' => 'mdl-right'));
 502         $sectionbottomnav .= html_writer::tag('div', $courselink, array('class' => 'mdl-align'));
 503         $sectionbottomnav .= html_writer::end_tag('div');
 504         echo $sectionbottomnav;
 505     }
 506
 507     /**
 508      * Output the html for a multiple section page
 509      *
 510      * @param stdClass $course The course entry from DB
 511      * @param array $sections The course_sections entries from the DB
 512      * @param array $mods used for print_section()
 513      * @param array $modnames used for print_section()
 514      * @param array $modnamesused used for print_section()
 515      */
 516     public function print_multiple_section_page($course, $sections, $mods, $modnames, $modnamesused) {
 517         global $PAGE;
 518
 519         $context = context_course::instance($course->id);
 520         // Title with completion help icon.
 521         $completioninfo = new completion_info($course);
 522         echo $completioninfo->display_help_icon();
 523         echo $this->output->heading($this->page_title(), 2, 'accesshide');
 524
 525         // Copy activity clipboard..
 526         echo $this->course_activity_clipboard($course);
 527
 528         // Now the list of sections..
 529         echo $this->start_section_list();
 530
 531         // General section if non-empty.
 532         $thissection = $sections[0];
 533         unset($sections[0]);
 534         if ($thissection->summary or $thissection->sequence or $PAGE->user_is_editing()) {
 535             echo $this->section_header($thissection, $course, true);
 536             print_section($course, $thissection, $mods, $modnamesused, true);
 537             if ($PAGE->user_is_editing()) {
 538                 print_section_add_menus($course, 0, $modnames);
 539             }
 540             echo $this->section_footer();
 541         }
 542
 543         $canviewhidden = has_capability('moodle/course:viewhiddensections', $context);
 544         for ($section = 1; $section <= $course->numsections; $section++) {
 545             if (!empty($sections[$section])) {
 546                 $thissection = $sections[$section];
 547             } else {
 548                 // This will create a course section if it doesn't exist..
 549                 $thissection = get_course_section($section, $course->id);
 550             }
 551             // Show the section if the user is permitted to access it, OR if it's not available
 552             // but showavailability is turned on
 553             $showsection = $thissection->uservisible ||
 554                     ($thissection->visible && !$thissection->available && $thissection->showavailability);
 555             if (!$showsection) {
 556                 // Hidden section message is overridden by 'unavailable' control
 557                 // (showavailability option).
 558                 if (!$course->hiddensections && $thissection->available) {
 559                     echo $this->section_hidden($section);
 560                 }
 561
 562                 unset($sections[$section]);
 563                 continue;
 564             }
 565
 566             if (!$PAGE->user_is_editing() && $course->coursedisplay == COURSE_DISPLAY_MULTIPAGE) {
 567                 // Display section summary only.
 568                 echo $this->section_summary($thissection, $course);
 569             } else {
 570                 echo $this->section_header($thissection, $course, false);
 571                 if ($thissection->uservisible) {
 572                     print_section($course, $thissection, $mods, $modnamesused);
 573                     if ($PAGE->user_is_editing()) {
 574                         print_section_add_menus($course, $section, $modnames);
 575                     }
 576                 }
 577                 echo $this->section_footer();
 578             }
 579
 580             unset($sections[$section]);
 581         }
 582
 583         if ($PAGE->user_is_editing() and has_capability('moodle/course:update', $context)) {
 584             // Print stealth sections if present.
 585             $modinfo = get_fast_modinfo($course);
 586             foreach ($sections as $section => $thissection) {
 587                 if (empty($modinfo->sections[$section])) {
 588                     continue;
 589                 }
 590                 echo $this->stealth_section_header($section);
 591                 print_section($course, $thissection, $mods, $modnamesused);
 592                 echo $this->stealth_section_footer();
 593             }
 594
 595             echo $this->end_section_list();
 596
 597             echo html_writer::start_tag('div', array('class' => 'mdl-right'));
 598
 599             // Increase number of sections.
 600             $straddsection = get_string('increasesections', 'moodle');
 601             $url = new moodle_url('/course/changenumsections.php',
 602                 array('courseid' => $course->id,
 603                       'increase' => true,
 604                       'sesskey' => sesskey()));
 605             $icon = $this->output->pix_icon('t/switch_plus', $straddsection);
 606             echo html_writer::link($url, $icon.get_accesshide($straddsection), array('class' => 'increase-sections'));
 607
 608             if ($course->numsections > 0) {
 609                 // Reduce number of sections sections.
 610                 $strremovesection = get_string('reducesections', 'moodle');
 611                 $url = new moodle_url('/course/changenumsections.php',
 612                     array('courseid' => $course->id,
 613                           'increase' => false,
 614                           'sesskey' => sesskey()));
 615                 $icon = $this->output->pix_icon('t/switch_minus', $strremovesection);
 616                 echo html_writer::link($url, $icon.get_accesshide($strremovesection), array('class' => 'reduce-sections'));
 617             }
 618
 619             echo html_writer::end_tag('div');
 620         } else {
 621             echo $this->end_section_list();
 622         }
 623
 624     }
 625
 626     /**
 627      * Generate html for a section summary text
 628      *
 629      * @param stdClass $section The course_section entry from DB
 630      * @return string HTML to output.
 631      */
 632     protected function format_summary_text($section) {
 633         $context = context_course::instance($section->course);
 634         $summarytext = file_rewrite_pluginfile_urls($section->summary, 'pluginfile.php',
 635             $context->id, 'course', 'section', $section->id);
 636
 637         $options = new stdClass();
 638         $options->noclean = true;
 639         $options->overflowdiv = true;
 640         return format_text($summarytext, $section->summaryformat, $options);
 641     }
 642 }