Moodle APIs  3.8
Moodle 3.8.6 (Build: 20201109)
Public Member Functions | Static Public Member Functions | Public Attributes | Protected Member Functions | Static Protected Member Functions | Protected Attributes | Static Protected Attributes | List of all members
tool_generator_site_backend Class Reference

Backend code for the site generator. More...

Inheritance diagram for tool_generator_site_backend:
tool_generator_backend

Public Member Functions

 __construct ($size, $bypasscheck, $fixeddataset=false, $filesizelimit=false, $progress=true)
 Constructs object ready to make the site. More...
 
 make ()
 Runs the entire 'make' process. More...
 

Static Public Member Functions

static get_size_choices ()
 Gets a list of size choices supported by this backend. More...
 
static size_for_name ($sizename)
 Converts a size name into the numeric constant. More...
 

Public Attributes

int const DEFAULT_SIZE = 3
 Default size index.
 
int const MAX_SIZE = 5
 Highest (largest) size index.
 
int const MIN_SIZE = 0
 Lowest (smallest) size index.
 
string const SHORTNAMEPREFIX = 'testcourse_'
 The course's shortname prefix.
 

Protected Member Functions

 dot ($number, $total)
 Outputs dots. More...
 
 end_log ()
 Ends a log string that was started using log function with $leaveopen.
 
 log ($langstring, $a=null, $leaveopen=false)
 Displays information as part of progress. More...
 
 run_create_course ($shortname, $coursesize)
 Creates a course with the specified shortname, coursesize and the provided maketestsite options. More...
 

Static Protected Member Functions

static get_last_testcourse_id ()
 Obtains the last unique sufix (numeric) using the test course prefix. More...
 

Protected Attributes

bool $bypasscheck
 If the debugging level checking was skipped.
 
int bool $filesizelimit
 Maximum number of bytes for file.
 
bool $fixeddataset
 True if we want a fixed dataset or false to generate random data.
 
int $lastdot
 Epoch time at which last dot was displayed.
 
int $lastpercentage
 Epoch time at which last percentage was displayed.
 
bool $progress
 True if displaying progress.
 
int $size
 Size code (index in the above arrays)
 
int $starttime
 Epoch time at which current step (current set of dots) started.
 

Static Protected Attributes

static array $sitecourses
 Multidimensional array where the first level is the course size and the second the site size. More...
 

Detailed Description

Backend code for the site generator.

License
http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Constructor & Destructor Documentation

◆ __construct()

tool_generator_site_backend::__construct (   $size,
  $bypasscheck,
  $fixeddataset = false,
  $filesizelimit = false,
  $progress = true 
)

Constructs object ready to make the site.

Parameters
int$sizeSize as numeric index
bool$bypasscheckIf debugging level checking was skipped.
bool$fixeddatasetTo use fixed or random data
int | bool$filesizelimitThe max number of bytes for a generated file
bool$progressTrue if progress information should be displayed
Return values
intCourse id

Member Function Documentation

◆ dot()

tool_generator_backend::dot (   $number,
  $total 
)
protectedinherited

Outputs dots.

There is up to one dot per second. Once a minute, it displays a percentage.

Parameters
int$numberNumber of completed items
int$totalTotal number of items to complete

◆ get_last_testcourse_id()

static tool_generator_site_backend::get_last_testcourse_id ( )
staticprotected

Obtains the last unique sufix (numeric) using the test course prefix.

Return values
intThe last generated numeric value.

◆ get_size_choices()

static tool_generator_site_backend::get_size_choices ( )
static

Gets a list of size choices supported by this backend.

Return values
arrayList of size (int) => text description for display

◆ log()

tool_generator_backend::log (   $langstring,
  $a = null,
  $leaveopen = false 
)
protectedinherited

Displays information as part of progress.

Parameters
string$langstringPart of langstring (after progress_)
mixed$aOptional lang string parameters
bool$leaveopenIf true, doesn't close LI tag (ready for dots)

◆ make()

tool_generator_site_backend::make ( )

Runs the entire 'make' process.

Return values
intCourse id

◆ run_create_course()

tool_generator_site_backend::run_create_course (   $shortname,
  $coursesize 
)
protected

Creates a course with the specified shortname, coursesize and the provided maketestsite options.

Parameters
string$shortnameThe course shortname
int$coursesizeOne of the possible course sizes.
Return values
void

◆ size_for_name()

static tool_generator_backend::size_for_name (   $sizename)
staticinherited

Converts a size name into the numeric constant.

Parameters
string$sizenameSize name e.g. 'L'
Return values
intNumeric version
Exceptions
coding_exceptionIf the size name is not known

Member Data Documentation

◆ $sitecourses

array tool_generator_site_backend::$sitecourses
staticprotected
Initial value:
= array(
array(2, 8, 64, 256, 1024, 4096),
array(1, 4, 8, 16, 32, 64),
array(0, 0, 1, 4, 8, 16),
array(0, 0, 0, 1, 0, 0),
array(0, 0, 0, 0, 1, 0),
array(0, 0, 0, 0, 0, 1)
)

Multidimensional array where the first level is the course size and the second the site size.


The documentation for this class was generated from the following file: