original_string: public static function get_folders_by_courses($courseids = array()) {
  
          $warnings = array();
          $returnedfolders = array();
  
          $params = array(
              'courseids' => $courseids,
          );
          $params = self::validate_parameters(self::get_folders_by_courses_parameters(), $params);
  
          $mycourses = array();
          if (empty($params['courseids'])) {
              $mycourses = enrol_get_my_courses();
              $params['courseids'] = array_keys($mycourses);
          }
  
          // Ensure there are courseids to loop through.
          if (!empty($params['courseids'])) {
  
              list($courses, $warnings) = external_util::validate_courses($params['courseids'], $mycourses);
  
              // Get the folders in this course, this function checks users visibility permissions.
              // We can avoid then additional validate_context calls.
              $folders = get_all_instances_in_courses("folder", $courses);
              foreach ($folders as $folder) {
                  $context = context_module::instance($folder->coursemodule);
                  // Entry to return.
                  $folder->name = external_format_string($folder->name, $context->id);
  
                  list($folder->intro, $folder->introformat) = external_format_text($folder->intro,
                                                                  $folder->introformat, $context->id, 'mod_folder', 'intro', null);
                  $folder->introfiles = external_util::get_area_files($context->id, 'mod_folder', 'intro', false, false);
  
                  $returnedfolders[] = $folder;
              }
          }
  
          $result = array(
              'folders' => $returnedfolders,
              'warnings' => $warnings
          );
          return $result;
      }
code: public static function get_folders_by_courses($courseids = array()) {
  
          $warnings = array();
          $returnedfolders = array();
  
          $params = array(
              'courseids' => $courseids,
          );
          $params = self::validate_parameters(self::get_folders_by_courses_parameters(), $params);
  
          $mycourses = array();
          if (empty($params['courseids'])) {
              $mycourses = enrol_get_my_courses();
              $params['courseids'] = array_keys($mycourses);
          }
  
          // Ensure there are courseids to loop through.
          if (!empty($params['courseids'])) {
  
              list($courses, $warnings) = external_util::validate_courses($params['courseids'], $mycourses);
  
              // Get the folders in this course, this function checks users visibility permissions.
              // We can avoid then additional validate_context calls.
              $folders = get_all_instances_in_courses("folder", $courses);
              foreach ($folders as $folder) {
                  $context = context_module::instance($folder->coursemodule);
                  // Entry to return.
                  $folder->name = external_format_string($folder->name, $context->id);
  
                  list($folder->intro, $folder->introformat) = external_format_text($folder->intro,
                                                                  $folder->introformat, $context->id, 'mod_folder', 'intro', null);
                  $folder->introfiles = external_util::get_area_files($context->id, 'mod_folder', 'intro', false, false);
  
                  $returnedfolders[] = $folder;
              }
          }
  
          $result = array(
              'folders' => $returnedfolders,
              'warnings' => $warnings
          );
          return $result;
      }
code_tokens: public static function get_folders_by_courses ( $ courseids = array ( ) ) { $ warnings = array ( ) ; $ returnedfolders = array ( ) ; $ params = array ( 'courseids' => $ courseids , ) ; $ params = self :: validate_parameters ( self :: get_folders_by_courses_parameters ( ) , $ params ) ; $ mycourses = array ( ) ; if ( empty ( $ params [ 'courseids' ] ) ) { $ mycourses = enrol_get_my_courses ( ) ; $ params [ 'courseids' ] = array_keys ( $ mycourses ) ; } // Ensure there are courseids to loop through. if ( ! empty ( $ params [ 'courseids' ] ) ) { list ( $ courses , $ warnings ) = external_util :: validate_courses ( $ params [ 'courseids' ] , $ mycourses ) ; // Get the folders in this course, this function checks users visibility permissions. // We can avoid then additional validate_context calls. $ folders = get_all_instances_in_courses ( "folder" , $ courses ) ; foreach ( $ folders as $ folder ) { $ context = context_module :: instance ( $ folder -> coursemodule ) ; // Entry to return. $ folder -> name = external_format_string ( $ folder -> name , $ context -> id ) ; list ( $ folder -> intro , $ folder -> introformat ) = external_format_text ( $ folder -> intro , $ folder -> introformat , $ context -> id , 'mod_folder' , 'intro' , null ) ; $ folder -> introfiles = external_util :: get_area_files ( $ context -> id , 'mod_folder' , 'intro' , false , false ) ; $ returnedfolders [ ] = $ folder ; } } $ result = array ( 'folders' => $ returnedfolders , 'warnings' => $ warnings ) ; return $ result ; }
docstring: Returns a list of folders in a provided list of courses.
  If no list is provided all folders that the user can view will be returned.
  
  @param array $courseids course ids
  @return array of warnings and folders
  @since Moodle 3.3
docstring_tokens: Returns a list of folders in a provided list of courses . If no list is provided all folders that the user can view will be returned .