This class is responsible for all file system related actions related actions of a skin such as copying files and folders, generating a new skin, deleting a skin etc. More...

Collaboration diagram for ilSystemStyleSkinContainer:

Public Member Functions
	__construct (ilSkinXML $skin, ilSystemStyleMessageStack $message_stack=null, ilSystemStyleConfig $system_styles_conf=null)
	ilSystemStyleSkinContainer constructor. More...

	create (ilSystemStyleMessageStack $message_stack)
	Creates a new skin. More...

	updateSkin (ilSkinXML $old_skin)
	Updates the skin. More...

	updateStyle ($style_id, ilSkinStyleXML $old_style)
	Updates one single style. More...

	createMainLessFile (ilSkinStyleXML $style)
	Creates the main less file. More...

	copyVariablesFromDefault (ilSkinStyleXML $style)
	Copies (resets) the variables file from delos. More...

	resetImages (ilSkinStyleXML $style)
	Copies (resets) the images from delos. More...

	copyCSSFromDefault (ilSkinStyleXML $style)
	Copies (resets) the images from delos. More...

	move ($from, $to)
	Used to move a complete directory of a skin. More...

	delete ()
	Deletes the container of a skin completely. More...

	deleteStyle (ilSkinStyleXML $style)
	Deletes a style completely. More...

	copy ()
	Copies a complete Skin. More...

	export ()
	Exports the complete skin to an zip file. More...

	createTempZip ()
	Creates a temp zip file. More...

	compileLess ($style_id)

	getSkin ()

	setSkin ($skin)

	getSkinDirectory ()

	getCSSFilePath ($style_id)

	getLessFilePath ($style_id)

	getLessVariablesFilePath ($style_id)

	getLessVariablesName ($style_id)

	getImagesSkinPath ($style_id)

	addStyle (ilSkinStyleXML $style)

	getSystemStylesConf ()

	setSystemStylesConf ($system_styles_conf)

Static Public Member Functions
static	generateFromId ($skin_id, ilSystemStyleMessageStack $message_stack=null, ilSystemStyleConfig $system_styles_conf=null)
	Generate the container class by parsing the corresponding XML. More...

static	xCopy ($src, $dest)
	Recursive copy of a folder. More...

static	recursiveRemoveDir ($dir)
	Recursive delete of a folder. More...

static	import ($import_zip_path, $name, ilSystemStyleMessageStack $message_stack=null, $system_styles_conf=null, $uploaded=true)
	Imports a skin from zip. More...

static	getMessageStack ()

static	setMessageStack ($message_stack)

Protected Member Functions
	resourcesStyleReferences ($resource)
	Checks if a given resource (folder) is still referenced by a style of the containers skin. More...

	createResourceDirectory ($source, $target)
	Creates a resource directory (sound, images or fonts) by copying from the source (mostly delos) More...

	changeResourceDirectory ($new_dir, $old_dir)
	Alters the name/path of a resource directory. More...

	removeResourceDirectory ($dir)
	Deletes a resource directory. More...

	createLessStructure (ilSkinStyleXML $style)
	Creates the less/css structure of a style. More...

	getLessMainFileDefautContent (ilSkinStyleXML $style)
	Returns the main less default content if a new style is created. More...

	deleteFile ($path)
	Deletes a given file in the container. More...

	changeVariablesImport ($main_path, $old_style_import, $new_style_import)

	writeSkinToXML ()

Protected Attributes
	$lng

	$skin

	$system_styles_conf

Static Protected Attributes
static	$message_stack = null

Detailed Description

This class is responsible for all file system related actions related actions of a skin such as copying files and folders, generating a new skin, deleting a skin etc.

It contains exactly one skin containing several styles. Use this class to parse a skin from xml.

Author: Timon Amstutz timon.nosp@m..ams.nosp@m.tutz@.nosp@m.ilub.nosp@m..unib.nosp@m.e.ch

Version: $Id$*

Definition at line 19 of file class.ilSystemStyleSkinContainer.php.

Constructor & Destructor Documentation

◆ __construct()

ilSystemStyleSkinContainer::__construct	(	ilSkinXML	$skin,
		ilSystemStyleMessageStack	$message_stack = `null`,
		ilSystemStyleConfig	$system_styles_conf = `null`
	)

ilSystemStyleSkinContainer constructor.

Parameters

ilSkinXML	$skin
ilSystemStyleMessageStack \| null	$message_stack
ilSystemStyleConfig	$system_styles_conf

Definition at line 54 of file class.ilSystemStyleSkinContainer.php.

References $DIC, $message_stack, $skin, $system_styles_conf, setMessageStack(), and setSystemStylesConf().

         {
                 global $DIC;
 
                 $this->lng = $DIC->language();
 
                 $this->skin = $skin;
 
                 if(!$message_stack){
                         $this->setMessageStack(new ilSystemStyleMessageStack());
                 }else{
                         $this->setMessageStack($message_stack);
                 }
 
                 if(!$system_styles_conf){
                         $this->setSystemStylesConf(new ilSystemStyleConfig());
                 }else{
                         $this->setSystemStylesConf($system_styles_conf);
                 }
         }

Here is the call graph for this function:

Member Function Documentation

◆ addStyle()

ilSystemStyleSkinContainer::addStyle ( ilSkinStyleXML $style )

Parameters

ilSkinStyleXML $style

Definition at line 720 of file class.ilSystemStyleSkinContainer.php.

References ilSkinStyleXML\getId(), getSkin(), and updateStyle().

                                                        {
                 $this->getSkin()->addStyle($style);
                 $old_style = new ilSkinStyleXML("","");
                 $this->updateStyle($style->getId(),  $old_style);
         }

Here is the call graph for this function:

◆ changeResourceDirectory()

ilSystemStyleSkinContainer::changeResourceDirectory	(	$new_dir,
		$old_dir
	)

protected

Alters the name/path of a resource directory.

Parameters

$new_dir
$old_dir

Exceptions

ilSystemStyleException

Definition at line 266 of file class.ilSystemStyleSkinContainer.php.

References getMessageStack(), getSkinDirectory(), resourcesStyleReferences(), and ilSystemStyleMessage\TYPE_SUCCESS.

Referenced by updateStyle().

                                                                      {
                 $absolut_new_dir = $this->getSkinDirectory().$new_dir;
                 $absolut_old_dir = $this->getSkinDirectory().$old_dir;
 
                 if(file_exists($absolut_new_dir)){
                         $this->getMessageStack()->addMessage(
                                 new ilSystemStyleMessage($this->lng->txt("dir_changed_to")." ".$absolut_new_dir,
                                         ilSystemStyleMessage::TYPE_SUCCESS
                                 ));
                         $this->getMessageStack()->addMessage(
                                 new ilSystemStyleMessage($this->lng->txt("dir_preserved_backup")." ".$absolut_old_dir,
                                         ilSystemStyleMessage::TYPE_SUCCESS
                                 ));
                 }else{
                         mkdir($absolut_new_dir,0777,true);
                         self::xCopy($absolut_old_dir, $absolut_new_dir);
                         $this->getMessageStack()->addMessage(
                                 new ilSystemStyleMessage($this->lng->txt("dir_copied_from")." ".$absolut_old_dir." ".$this->lng->txt("to")." ".$absolut_new_dir,
                                         ilSystemStyleMessage::TYPE_SUCCESS
                                 ));
                         if(count($this->resourcesStyleReferences($old_dir))==0){
                                 self::recursiveRemoveDir(self::getSkinDirectory().$old_dir);
                                 $this->getMessageStack()->addMessage(
                                         new ilSystemStyleMessage($this->lng->txt("dir_deleted")." ".$absolut_old_dir,
                                                 ilSystemStyleMessage::TYPE_SUCCESS
                                         ));
                         }else{
                                 $this->getMessageStack()->addMessage(
                                         new ilSystemStyleMessage($this->lng->txt("dir_preserved_linked")." ".$absolut_old_dir,
                                                 ilSystemStyleMessage::TYPE_SUCCESS
                                         ));
                         }
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ changeVariablesImport()

ilSystemStyleSkinContainer::changeVariablesImport	(	$main_path,
		$old_style_import,
		$new_style_import
	)

protected

Parameters

$main_path
$old_style_import
$new_style_import

Definition at line 608 of file class.ilSystemStyleSkinContainer.php.

Referenced by updateStyle().

                                                                                                 {
                 $main_less_content = file_get_contents($main_path);
                 $main_less_content = str_replace("@import \"".$old_style_import,
                         "@import \"".$new_style_import,
                         $main_less_content);
                 file_put_contents($main_path,$main_less_content);
         }

Here is the caller graph for this function:

◆ compileLess()

ilSystemStyleSkinContainer::compileLess ( $style_id )

Parameters

$style_id

Exceptions

ilSystemStyleException

Definition at line 620 of file class.ilSystemStyleSkinContainer.php.

References $output, getCSSFilePath(), ilSystemStyleException\LESS_COMPILE_FAILED, and ilSystemStyleException\LESSC_NOT_INSTALLED.

Referenced by createLessStructure(), and updateStyle().

                                               {
 
                 if(!PATH_TO_LESSC){
                         throw new ilSystemStyleException(ilSystemStyleException::LESSC_NOT_INSTALLED);
                 }
 
                 $output = shell_exec(PATH_TO_LESSC." ".$this->getLessFilePath($style_id));
                 if(!$output){
                         $less_error = shell_exec(PATH_TO_LESSC." ".$this->getLessFilePath($style_id)." 2>&1");
                         if(!$less_error){
                                 throw new ilSystemStyleException(ilSystemStyleException::LESS_COMPILE_FAILED, "Empty css output, unknown error.");
                         }
                         throw new ilSystemStyleException(ilSystemStyleException::LESS_COMPILE_FAILED, $less_error);
                 }
                 file_put_contents($this->getCSSFilePath($style_id),$output);
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ copy()

ilSystemStyleSkinContainer::copy ( )

Copies a complete Skin.

Returns: ilSystemStyleSkinContainer

Exceptions

ilSystemStyleException

Definition at line 532 of file class.ilSystemStyleSkinContainer.php.

References getMessageStack(), getSkin(), getSkinDirectory(), getSystemStylesConf(), ilStyleDefinition\skinExists(), ilSystemStyleMessage\TYPE_SUCCESS, and xCopy().

Referenced by copyCSSFromDefault(), updateStyle(), and xCopy().

                               {
                 $new_skin_id_addon = "";
 
                 while(ilStyleDefinition::skinExists($this->getSkin()->getId().$new_skin_id_addon, $this->getSystemStylesConf())){
                         $new_skin_id_addon .= "Copy";
                 }
 
                 $new_skin_path = rtrim($this->getSkinDirectory(),"/").$new_skin_id_addon;
 
                 mkdir($new_skin_path,0777,true);
                 $this->xCopy($this->getSkinDirectory(),$new_skin_path);
                 $this->getMessageStack()->addMessage(new ilSystemStyleMessage($this->lng->txt("directory_created")." ".$new_skin_path,ilSystemStyleMessage::TYPE_SUCCESS));
                 return self::generateFromId($this->getSkin()->getId().$new_skin_id_addon,null,$this->getSystemStylesConf());
 
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ copyCSSFromDefault()

ilSystemStyleSkinContainer::copyCSSFromDefault ( ilSkinStyleXML $style )

Copies (resets) the images from delos.

Parameters

ilSkinStyleXML $style

Definition at line 380 of file class.ilSystemStyleSkinContainer.php.

References copy(), getCSSFilePath(), ilSkinStyleXML\getId(), and getSystemStylesConf().

Referenced by createLessStructure().

                                                                  {
                 copy ($this->getSystemStylesConf()->getDelosPath().".css",$this->getCSSFilePath($style->getId()));
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ copyVariablesFromDefault()

ilSystemStyleSkinContainer::copyVariablesFromDefault ( ilSkinStyleXML $style )

Copies (resets) the variables file from delos.

Parameters

ilSkinStyleXML $style

Returns: ilSystemStyleLessFile

Definition at line 358 of file class.ilSystemStyleSkinContainer.php.

References ilSkinStyleXML\getId(), getLessVariablesFilePath(), and getSystemStylesConf().

Referenced by createLessStructure(), and updateStyle().

                                                                        {
                 $less_file = new ilSystemStyleLessFile($this->getSystemStylesConf()->getDefaultVariablesPath());
                 $less_file->setLessVariablesFile($this->getLessVariablesFilePath($style->getId()));
                 $less_file->write();
                 return $less_file;
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ create()

ilSystemStyleSkinContainer::create ( ilSystemStyleMessageStack $message_stack )

Creates a new skin.

This includes the generation of the XML and the corresponding folders of all contained styles.

Parameters

ilSystemStyleMessageStack $message_stack

Exceptions

ilSystemStyleException

Definition at line 108 of file class.ilSystemStyleSkinContainer.php.

References $style, ilSystemStyleMessageStack\addMessage(), createLessStructure(), createResourceDirectory(), getSkin(), getSkinDirectory(), getSystemStylesConf(), ilSystemStyleException\SKIN_ALREADY_EXISTS, ilSystemStyleMessage\TYPE_ERROR, and writeSkinToXML().

                                                                         {
                 if(file_exists($this->getSkinDirectory())){
                         throw new ilSystemStyleException(ilSystemStyleException::SKIN_ALREADY_EXISTS,$this->getSkinDirectory());
                 }
 
 
                 mkdir($this->getSkinDirectory(),0777,true);
 
                 foreach($this->getSkin()->getStyles() as $style){
                         $this->createResourceDirectory($this->getSystemStylesConf()->getDefaultImagesPath(),$style->getImageDirectory());
                         $this->createResourceDirectory($this->getSystemStylesConf()->getDefaultSoundsPath(),$style->getSoundDirectory());
                         $this->createResourceDirectory($this->getSystemStylesConf()->getDefaultFontsPath(),$style->getFontDirectory());
                         try{
                                 $this->createLessStructure($style);
                         }catch(Exception $e){
                                 $message_stack->addMessage(new ilSystemStyleMessage($this->lng->txt("less_compile_failed")." ".$e->getMessage(),ilSystemStyleMessage::TYPE_ERROR));
                         }
 
                 }
                 $this->writeSkinToXML();
 
 
         }

Here is the call graph for this function:

◆ createLessStructure()

ilSystemStyleSkinContainer::createLessStructure ( ilSkinStyleXML $style )

protected

Creates the less/css structure of a style.

Parameters

ilSkinStyleXML $style

Exceptions

ilSystemStyleException

Definition at line 331 of file class.ilSystemStyleSkinContainer.php.

References compileLess(), copyCSSFromDefault(), copyVariablesFromDefault(), createMainLessFile(), and ilSkinStyleXML\getId().

Referenced by create().

                                                                      {
                 $this->createMainLessFile($style);
                 $this->copyVariablesFromDefault($style);
                 $this->copyCSSFromDefault($style);
                 $this->compileLess($style->getId());
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createMainLessFile()

ilSystemStyleSkinContainer::createMainLessFile ( ilSkinStyleXML $style )

Creates the main less file.

Parameters

ilSkinStyleXML $style

Definition at line 343 of file class.ilSystemStyleSkinContainer.php.

References $path, ilSkinStyleXML\getId(), getLessFilePath(), getLessMainFileDefautContent(), getMessageStack(), and ilSystemStyleMessage\TYPE_SUCCESS.

Referenced by createLessStructure(), and updateStyle().

                                                                  {
                 $path = $this->getLessFilePath($style->getId());
                 file_put_contents($path,$this->getLessMainFileDefautContent($style));
                 $this->getMessageStack()->addMessage(
                         new ilSystemStyleMessage($this->lng->txt("main_less_created")." ".$path,
                                 ilSystemStyleMessage::TYPE_SUCCESS
                         ));
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createResourceDirectory()

ilSystemStyleSkinContainer::createResourceDirectory	(	$source,
		$target
	)

protected

Creates a resource directory (sound, images or fonts) by copying from the source (mostly delos)

Parameters

$source
$target

Exceptions

ilSystemStyleException

Definition at line 245 of file class.ilSystemStyleSkinContainer.php.

References $path, getMessageStack(), getSkinDirectory(), and ilSystemStyleMessage\TYPE_SUCCESS.

Referenced by create(), resetImages(), and updateStyle().

                                                                     {
                 $path = $this->getSkinDirectory().$target;
 
                 mkdir($path,0777,true);
 
                 if($source != ""){
                         self::xCopy($source,$path);
                         $this->getMessageStack()->addMessage(
                                 new ilSystemStyleMessage($this->lng->txt("dir_created").$path,
                                         ilSystemStyleMessage::TYPE_SUCCESS
                                 ));
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ createTempZip()

ilSystemStyleSkinContainer::createTempZip ( )

Creates a temp zip file.

Returns: string $temp_path

Definition at line 560 of file class.ilSystemStyleSkinContainer.php.

References getSkinDirectory(), and ilUtil\zip().

Referenced by export().

                                        {
                 $rel_tmp_zip = "../".$this->getSkin()->getId().".zip";
                 ilUtil::zip($this->getSkinDirectory(),$rel_tmp_zip,true);
                 return rtrim($this->getSkinDirectory(),"/").".zip";
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ delete()

ilSystemStyleSkinContainer::delete ( )

Deletes the container of a skin completely.

Definition at line 472 of file class.ilSystemStyleSkinContainer.php.

References getMessageStack(), and ilSystemStyleMessage\TYPE_SUCCESS.

                                 {
                 self::recursiveRemoveDir(self::getSkinDirectory());
                 $this->getMessageStack()->addMessage(
                         new ilSystemStyleMessage($this->lng->txt("skin_deleted").$this->getSkinDirectory(),
                                 ilSystemStyleMessage::TYPE_SUCCESS
                         ));
         }

Here is the call graph for this function:

◆ deleteFile()

ilSystemStyleSkinContainer::deleteFile ( $path )

protected

Deletes a given file in the container.

Parameters

$path

Definition at line 485 of file class.ilSystemStyleSkinContainer.php.

References $path, getMessageStack(), and ilSystemStyleMessage\TYPE_SUCCESS.

Referenced by deleteStyle().

                                             {
                 if(file_exists($path)){
                         unlink($path);
                         $this->getMessageStack()->addMessage(
                                 new ilSystemStyleMessage($this->lng->txt("file_deleted") . " " . $path,
                                         ilSystemStyleMessage::TYPE_SUCCESS
                                 ));
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ deleteStyle()

ilSystemStyleSkinContainer::deleteStyle ( ilSkinStyleXML $style )

Deletes a style completely.

Parameters

ilSkinStyleXML $style

Definition at line 500 of file class.ilSystemStyleSkinContainer.php.

References deleteFile(), ilSystemStyleSettings\deleteSubStyleCategoryAssignments(), getCSSFilePath(), ilSkinStyleXML\getFontDirectory(), ilSkinStyleXML\getId(), ilSkinStyleXML\getImageDirectory(), getLessFilePath(), getLessVariablesFilePath(), getMessageStack(), ilSkinStyleXML\getName(), getSkin(), ilSkinStyleXML\getSoundDirectory(), ilSkinStyleXML\getSubstyleOf(), ilSkinStyleXML\isSubstyle(), removeResourceDirectory(), ilSystemStyleMessage\TYPE_SUCCESS, and writeSkinToXML().

                                                           {
                 if($style->isSubstyle()){
                         ilSystemStyleSettings::deleteSubStyleCategoryAssignments($this->getSkin()->getId(),$style->getSubstyleOf(),$style->getId());
                         $this->getMessageStack()->prependMessage(
                                 new ilSystemStyleMessage($this->lng->txt("style_assignments_deleted")." ".$style->getName(),
                                         ilSystemStyleMessage::TYPE_SUCCESS
                                 ));
                 }
 
                 $this->deleteFile($this->getLessFilePath($style->getId()));
                 $this->deleteFile($this->getCSSFilePath($style->getId()));
                 $this->deleteFile($this->getLessVariablesFilePath($style->getId()));
 
                 $this->getSkin()->removeStyle($style->getId());
 
                 $this->removeResourceDirectory($style->getImageDirectory());
                 $this->removeResourceDirectory($style->getFontDirectory());
                 $this->removeResourceDirectory($style->getSoundDirectory());
 
                 $this->writeSkinToXML();
                 $this->getMessageStack()->prependMessage(
                         new ilSystemStyleMessage($this->lng->txt("style_deleted")." ".$style->getName(),
                                 ilSystemStyleMessage::TYPE_SUCCESS
                         ));
         }

Here is the call graph for this function:

◆ export()

ilSystemStyleSkinContainer::export ( )

Exports the complete skin to an zip file.

Definition at line 551 of file class.ilSystemStyleSkinContainer.php.

References createTempZip(), ilFileDelivery\deliverFileAttached(), and getSkin().

                                 {
                 ilFileDelivery::deliverFileAttached($this->createTempZip(), $this->getSkin()->getId().".zip",null, true);
         }

Here is the call graph for this function:

◆ generateFromId()

static ilSystemStyleSkinContainer::generateFromId	(		$skin_id,
		ilSystemStyleMessageStack	$message_stack = `null`,
		ilSystemStyleConfig	$system_styles_conf = `null`
	)

static

Generate the container class by parsing the corresponding XML.

Parameters

	$skin_id
ilSystemStyleMessageStack \| null	$message_stack
ilSystemStyleConfig	$system_styles_conf

Returns: ilSystemStyleSkinContainer

Exceptions

ilSystemStyleException

Definition at line 84 of file class.ilSystemStyleSkinContainer.php.

References $message_stack, $system_styles_conf, and ilSystemStyleException\NO_SKIN_ID.

                                                                                                                                                 {
                 if(!$skin_id){
                         throw new ilSystemStyleException(ilSystemStyleException::NO_SKIN_ID);
                 }
 
                 if(!$system_styles_conf){
                         $system_styles_conf = new ilSystemStyleConfig();
                 }
 
                 if ($skin_id != "default")
                 {
                         return new self(ilSkinXML::parseFromXML($system_styles_conf->getCustomizingSkinPath().$skin_id."/template.xml"), $message_stack, $system_styles_conf);
                 }else{
                         return new self(ilSkinXML::parseFromXML($system_styles_conf->getDefaultTemplatePath()), $message_stack, $system_styles_conf);
                 }
 
         }

Here is the caller graph for this function:

◆ getCSSFilePath()

ilSystemStyleSkinContainer::getCSSFilePath ( $style_id )

Parameters

$style_id

Returns: string

Definition at line 665 of file class.ilSystemStyleSkinContainer.php.

References getSkinDirectory().

Referenced by compileLess(), copyCSSFromDefault(), deleteStyle(), and updateStyle().

                                                  {
                 return $this->getSkinDirectory().$this->getSkin()->getStyle($style_id)->getCssFile().".css";
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getImagesSkinPath()

ilSystemStyleSkinContainer::getImagesSkinPath ( $style_id )

Parameters

$style_id

Returns: string

Definition at line 697 of file class.ilSystemStyleSkinContainer.php.

References getSkinDirectory().

                                                     {
                 return $this->getSkinDirectory().$this->getSkin()->getStyle($style_id)->getImageDirectory();
         }

Here is the call graph for this function:

◆ getLessFilePath()

ilSystemStyleSkinContainer::getLessFilePath ( $style_id )

Parameters

$style_id

Returns: string

Definition at line 673 of file class.ilSystemStyleSkinContainer.php.

References getSkinDirectory().

Referenced by createMainLessFile(), deleteStyle(), and updateStyle().

                                                   {
                 return $this->getSkinDirectory().$this->getSkin()->getStyle($style_id)->getCssFile().".less";
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getLessMainFileDefautContent()

ilSystemStyleSkinContainer::getLessMainFileDefautContent ( ilSkinStyleXML $style )

protected

Returns the main less default content if a new style is created.

Parameters

ilSkinStyleXML $style

Returns: string

Definition at line 447 of file class.ilSystemStyleSkinContainer.php.

References ilSkinStyleXML\getId(), and getSystemStylesConf().

Referenced by createMainLessFile().

                                                                               {
                 $less_delos_import = $this->getSystemStylesConf()->getDelosPath();
                 $less_delos_import = str_replace("./","../../../../",$less_delos_import);
                 $content = "@import \"".$less_delos_import."\";\n";
 
                 $content .= "// Import Custom Less Files here\n";
 
                 $content .= "@import \"".$this->getLessVariablesName($style->getId())."\";\n";
                 return $content;
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getLessVariablesFilePath()

ilSystemStyleSkinContainer::getLessVariablesFilePath ( $style_id )

Parameters

$style_id

Returns: string

Definition at line 681 of file class.ilSystemStyleSkinContainer.php.

References getSkinDirectory().

Referenced by copyVariablesFromDefault(), deleteStyle(), and updateStyle().

                                                            {
                 return $this->getSkinDirectory().$this->getLessVariablesName($style_id);
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getLessVariablesName()

ilSystemStyleSkinContainer::getLessVariablesName ( $style_id )

Parameters

$style_id

Returns: string

Definition at line 689 of file class.ilSystemStyleSkinContainer.php.

References getSkin().

Referenced by updateStyle().

                                                        {
                 return $this->getSkin()->getStyle($style_id)->getCssFile()."-variables.less";
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getMessageStack()

static ilSystemStyleSkinContainer::getMessageStack ( )

static

Returns: ilSystemStyleMessageStack

Definition at line 704 of file class.ilSystemStyleSkinContainer.php.

Referenced by changeResourceDirectory(), copy(), createMainLessFile(), createResourceDirectory(), delete(), deleteFile(), deleteStyle(), removeResourceDirectory(), and updateStyle().

         {
                 return self::$message_stack;
         }

Here is the caller graph for this function:

◆ getSkin()

ilSystemStyleSkinContainer::getSkin ( )

Returns: ilSkinXML

Definition at line 639 of file class.ilSystemStyleSkinContainer.php.

References $skin.

Referenced by addStyle(), copy(), create(), deleteStyle(), export(), getLessVariablesName(), resourcesStyleReferences(), updateSkin(), updateStyle(), and writeSkinToXML().

         {
                 return $this->skin;
         }

Here is the caller graph for this function:

◆ getSkinDirectory()

ilSystemStyleSkinContainer::getSkinDirectory ( )

Returns: mixed

Definition at line 655 of file class.ilSystemStyleSkinContainer.php.

References getSystemStylesConf().

Referenced by changeResourceDirectory(), copy(), create(), createResourceDirectory(), createTempZip(), getCSSFilePath(), getImagesSkinPath(), getLessFilePath(), getLessVariablesFilePath(), removeResourceDirectory(), resetImages(), updateSkin(), updateStyle(), and writeSkinToXML().

         {
                 return $this->getSystemStylesConf()->getCustomizingSkinPath().$this->getSkin()->getId()."/";
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ getSystemStylesConf()

ilSystemStyleSkinContainer::getSystemStylesConf ( )

Returns: ilSystemStyleConfig

Definition at line 733 of file class.ilSystemStyleSkinContainer.php.

References $system_styles_conf.

Referenced by copy(), copyCSSFromDefault(), copyVariablesFromDefault(), create(), getLessMainFileDefautContent(), getSkinDirectory(), resetImages(), updateSkin(), and updateStyle().

         {
                 return $this->system_styles_conf;
         }

Here is the caller graph for this function:

◆ import()

static ilSystemStyleSkinContainer::import	(		$import_zip_path,
			$name,
		ilSystemStyleMessageStack	$message_stack = `null`,
			$system_styles_conf = `null`,
			$uploaded = `true`
	)

static

Imports a skin from zip.

Parameters

	$import_zip_path
	$name
ilSystemStyleMessageStack \| null	$message_stack
null	$system_styles_conf
bool \| true	$uploaded

Returns: ilSystemStyleSkinContainer

Exceptions

ilSystemStyleException

Definition at line 577 of file class.ilSystemStyleSkinContainer.php.

References ilStyleDefinition\skinExists(), and ilUtil\unzip().

Referenced by ilSystemStyleOverviewGUI\importStyle().

                                                                                                                                                             {
                 if(!$system_styles_conf){
                         $system_styles_conf = new ilSystemStyleConfig();
                 }
 
                 $skin_id = preg_replace('/[^A-Za-z0-9\-_]/', '', rtrim($name,".zip"));
 
                 while(ilStyleDefinition::skinExists($skin_id,$system_styles_conf)){
                         $skin_id .= "Copy";
                 }
 
                 $skin_path = $system_styles_conf->getCustomizingSkinPath().$skin_id;
                 mkdir($skin_path,0777,true);
 
                 $temp_zip_path = $skin_path."/".$name;
                 if($uploaded){
                         move_uploaded_file ( $import_zip_path ,$temp_zip_path );
                 }else{
                         rename( $import_zip_path ,$temp_zip_path );
                 }
                 ilUtil::unzip($temp_zip_path);
                 unlink($temp_zip_path);
 
                 return self::generateFromId($skin_id,$message_stack,$system_styles_conf);
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ move()

ilSystemStyleSkinContainer::move	(	$from,
		$to
	)

Used to move a complete directory of a skin.

Parameters

$from
$to

Definition at line 464 of file class.ilSystemStyleSkinContainer.php.

Referenced by updateSkin().

                                        {
                 rename($from,$to);
         }

Here is the caller graph for this function:

◆ recursiveRemoveDir()

static ilSystemStyleSkinContainer::recursiveRemoveDir ( $dir )

static

Recursive delete of a folder.

Parameters

$dir

Definition at line 425 of file class.ilSystemStyleSkinContainer.php.

Referenced by ilSkinStyleLessFileTest\tearDown(), ilSystemStyleStyleLessFileTest\tearDown(), ilSkinXMLTest\tearDown(), ilSystemStyleSkinXMLTest\tearDown(), ilSystemStyleIconFolderTest\tearDown(), ilSystemStyleIconTest\tearDown(), and ilSystemStyleSkinContainerTest\tearDown().

                                                 {
                 if (is_dir($dir)) {
                         $objects = scandir($dir);
                         foreach ($objects as $object) {
                                 if ($object != "." && $object != "..") {
                                         if (is_dir($dir."/".$object))
                                                 self::recursiveRemoveDir($dir."/".$object);
                                         else
                                                 unlink($dir."/".$object);
                                 }
                         }
                         rmdir($dir);
                 }
         }

Here is the caller graph for this function:

◆ removeResourceDirectory()

ilSystemStyleSkinContainer::removeResourceDirectory ( $dir )

protected

Deletes a resource directory.

Parameters

$dir

Definition at line 306 of file class.ilSystemStyleSkinContainer.php.

References getMessageStack(), getSkinDirectory(), resourcesStyleReferences(), and ilSystemStyleMessage\TYPE_SUCCESS.

Referenced by deleteStyle().

                                                         {
                 $absolut_dir = $this->getSkinDirectory().$dir;
 
                 if(file_exists($absolut_dir)) {
                         if (count($this->resourcesStyleReferences($dir)) == 0) {
                                 self::recursiveRemoveDir($this->getSkinDirectory() . $dir);
                                 $this->getMessageStack()->addMessage(
                                         new ilSystemStyleMessage($this->lng->txt("dir_deleted")." ". $dir,
                                                 ilSystemStyleMessage::TYPE_SUCCESS
                                         ));
                         } else {
                                 $this->getMessageStack()->addMessage(
                                         new ilSystemStyleMessage($this->lng->txt("dir_preserved_linked")." ". $dir,
                                                 ilSystemStyleMessage::TYPE_SUCCESS
                                         ));
                         }
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ resetImages()

ilSystemStyleSkinContainer::resetImages ( ilSkinStyleXML $style )

Copies (resets) the images from delos.

Parameters

ilSkinStyleXML $style

Definition at line 370 of file class.ilSystemStyleSkinContainer.php.

References createResourceDirectory(), ilSkinStyleXML\getImageDirectory(), getSkinDirectory(), and getSystemStylesConf().

                                                           {
                 self::recursiveRemoveDir($this->getSkinDirectory().$style->getImageDirectory());
                 $this->createResourceDirectory($this->getSystemStylesConf()->getDefaultImagesPath(),$style->getImageDirectory());
         }

Here is the call graph for this function:

◆ resourcesStyleReferences()

ilSystemStyleSkinContainer::resourcesStyleReferences ( $resource )

protected

Checks if a given resource (folder) is still referenced by a style of the containers skin.

Parameters

$resource

Returns: array

Definition at line 227 of file class.ilSystemStyleSkinContainer.php.

References $style, array, and getSkin().

Referenced by changeResourceDirectory(), and removeResourceDirectory().

                                                               {
                 $references_ids = array();
                 foreach ($this->getSkin()->getStyles() as $style) {
                         if($style->referencesResource($resource)){
                                 $references_ids[] = $style->getId();
                         }
                 }
                 return $references_ids;
 
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ setMessageStack()

static ilSystemStyleSkinContainer::setMessageStack ( $message_stack )

static

Parameters

ilSystemStyleMessageStack $message_stack

Definition at line 712 of file class.ilSystemStyleSkinContainer.php.

References $message_stack.

Referenced by __construct().

         {
                 self::$message_stack = $message_stack;
         }

Here is the caller graph for this function:

◆ setSkin()

ilSystemStyleSkinContainer::setSkin ( $skin )

Parameters

ilSkinXML $skin

Definition at line 647 of file class.ilSystemStyleSkinContainer.php.

References $skin.

         {
                 $this->skin = $skin;
         }

◆ setSystemStylesConf()

ilSystemStyleSkinContainer::setSystemStylesConf ( $system_styles_conf )

Parameters

ilSystemStyleConfig $system_styles_conf

Definition at line 741 of file class.ilSystemStyleSkinContainer.php.

References $system_styles_conf.

Referenced by __construct().

         {
                 $this->system_styles_conf = $system_styles_conf;
         }

Here is the caller graph for this function:

◆ updateSkin()

ilSystemStyleSkinContainer::updateSkin ( ilSkinXML $old_skin )

Updates the skin.

Style are not updated, use updateStyle for that.

Parameters

ilSkinXML $old_skin

Exceptions

ilSystemStyleException

Definition at line 138 of file class.ilSystemStyleSkinContainer.php.

References ilSkinXML\getId(), getSkin(), getSkinDirectory(), getSystemStylesConf(), move(), and writeSkinToXML().

                                                        {
                 $old_customizing_skin_directory = $this->getSystemStylesConf()->getCustomizingSkinPath().$old_skin->getId()."/";
 
                 //Move if skin id has been changed
                 if($old_skin->getId()!= $this->getSkin()->getId()){
                         $this->move($old_customizing_skin_directory,$this->getSkinDirectory());
                 }
 
                 //Delete old template.xml and write a new one
                 unlink($this->getSkinDirectory()."template.xml");
                 $this->writeSkinToXML();
         }

Here is the call graph for this function:

◆ updateStyle()

ilSystemStyleSkinContainer::updateStyle	(		$style_id,
		ilSkinStyleXML	$old_style
	)

Updates one single style.

Parameters

	$style_id
ilSkinStyleXML	$old_style

Definition at line 157 of file class.ilSystemStyleSkinContainer.php.

References $style, changeResourceDirectory(), changeVariablesImport(), compileLess(), copy(), copyVariablesFromDefault(), createMainLessFile(), createResourceDirectory(), ilSkinStyleXML\getCssFile(), getCSSFilePath(), ilSkinStyleXML\getFontDirectory(), ilSkinStyleXML\getImageDirectory(), getLessFilePath(), getLessVariablesFilePath(), getLessVariablesName(), getMessageStack(), getSkin(), getSkinDirectory(), ilSkinStyleXML\getSoundDirectory(), getSystemStylesConf(), ilSystemStyleMessage\TYPE_ERROR, and writeSkinToXML().

Referenced by addStyle().

                                                                          {
                 $style = $this->getSkin()->getStyle($style_id);
 
                 if($style->getImageDirectory()!=$old_style->getImageDirectory())
                 {
                         if(file_exists($this->getSkinDirectory().$old_style->getImageDirectory())){
                                 $this->changeResourceDirectory($style->getImageDirectory(),$old_style->getImageDirectory());
                         }else{
                                 $this->createResourceDirectory($this->getSystemStylesConf()->getDefaultImagesPath(),$style->getImageDirectory());
                         }
                 }
 
                 if($style->getFontDirectory()!=$old_style->getFontDirectory())
                 {
                         if(file_exists($this->getSkinDirectory().$old_style->getFontDirectory())){
                                 $this->changeResourceDirectory($style->getFontDirectory(),$old_style->getFontDirectory());
                         }else{
                                 $this->createResourceDirectory($this->getSystemStylesConf()->getDefaultFontsPath(),$style->getFontDirectory());
                         }
                 }
 
                 if($style->getSoundDirectory()!=$old_style->getSoundDirectory())
                 {
                         if(file_exists($this->getSkinDirectory().$old_style->getSoundDirectory())){
                                 $this->changeResourceDirectory($style->getSoundDirectory(),$old_style->getSoundDirectory());
                         }else{
                                 $this->createResourceDirectory($this->getSystemStylesConf()->getDefaultSoundsPath(),$style->getSoundDirectory());
                         }
                 }
 
 
 
                 if(file_exists($this->getSkinDirectory().$old_style->getCssFile().".less")){
                         rename($this->getSkinDirectory().$old_style->getCssFile().".less", $this->getLessFilePath($style->getId()));
                 }else{
                         $this->createMainLessFile($style);
                 }
 
                 if(file_exists($this->getSkinDirectory().$old_style->getCssFile()."-variables.less")){
                         rename($this->getSkinDirectory().$old_style->getCssFile()."-variables.less", $this->getLessVariablesFilePath($style->getId()));
                 }else{
                         $this->copyVariablesFromDefault($style);
                 }
 
                 $this->changeVariablesImport($this->getLessFilePath($style->getId()),$old_style->getCssFile()."-variables.less",$this->getLessVariablesName($style->getId()));
 
                 if(file_exists($this->getSkinDirectory().$old_style->getCssFile().".css")){
                         rename($this->getSkinDirectory().$old_style->getCssFile().".css", $this->getCSSFilePath($style->getId()));
                 }else{
                         try{
                                 $this->compileLess($style->getId());
                         }catch(Exception $e){
                                 $this->getMessageStack()->addMessage(
                                         new ilSystemStyleMessage($e->getMessage(),
                                                 ilSystemStyleMessage::TYPE_ERROR
                                         ));
                                 copy ($this->getSystemStylesConf()->getDelosPath().".css",$this->getCSSFilePath($style->getId()));
                         }
                 }
 
                 $this->writeSkinToXML();
 
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ writeSkinToXML()

ilSystemStyleSkinContainer::writeSkinToXML ( )

protected

Definition at line 726 of file class.ilSystemStyleSkinContainer.php.

References getSkin(), and getSkinDirectory().

Referenced by create(), deleteStyle(), updateSkin(), and updateStyle().

                                            {
                 $this->getSkin()->writeToXMLFile($this->getSkinDirectory()."template.xml");
         }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ xCopy()

static ilSystemStyleSkinContainer::xCopy	(	$src,
		$dest
	)

static

Recursive copy of a folder.

Parameters

$src
$dest

Exceptions

ilSystemStyleException

Definition at line 391 of file class.ilSystemStyleSkinContainer.php.

References $file, copy(), ilSystemStyleException\FILE_CREATION_FAILED, ilSystemStyleException\FILE_OPENING_FAILED, and ilSystemStyleException\FOLDER_CREATION_FAILED.

Referenced by copy(), ilSkinStyleLessFileTest\setUp(), ilSystemStyleStyleLessFileTest\setUp(), ilSkinXMLTest\setUp(), ilSystemStyleSkinXMLTest\setUp(), ilSystemStyleSkinContainerTest\setUp(), ilSystemStyleIconFolderTest\setUp(), and ilSystemStyleIconTest\setUp().

         {
                 foreach (scandir($src) as $file) {
                         $src_file = rtrim($src, '/') . '/' . $file;
                         $dest_file = rtrim($dest, '/') . '/' . $file;
                         if (!is_readable($src_file)) {
                                 throw new ilSystemStyleException(ilSystemStyleException::FILE_OPENING_FAILED, $src_file);
                         }
                         if (substr($file, 0, 1) != ".") {
                                 if (is_dir($src_file)) {
                                         if (!file_exists($dest_file)) {
                                                 try {
                                                         mkdir($dest_file);
                                                 } catch (Exception $e) {
                                                         throw new ilSystemStyleException(ilSystemStyleException::FOLDER_CREATION_FAILED, "Copy " . $src_file . " to " . $dest_file . " Error: " . $e);
                                                 }
                                         }
                                         self::xCopy($src_file, $dest_file);
                                 } else {
                                         try {
                                                 copy($src_file,$dest_file);
                                         } catch (Exception $e) {
                                                 throw new ilSystemStyleException(ilSystemStyleException::FILE_CREATION_FAILED, "Copy " . $src_file . " to " . $dest_file . " Error: " . $e);
                                         }
                                 }
                         }
                 }
         }

Here is the call graph for this function:

Here is the caller graph for this function:

Field Documentation

◆ $lng

ilSystemStyleSkinContainer::$lng

protected

Definition at line 24 of file class.ilSystemStyleSkinContainer.php.

◆ $message_stack

ilSystemStyleSkinContainer::$message_stack = null

staticprotected

Definition at line 38 of file class.ilSystemStyleSkinContainer.php.

Referenced by __construct(), generateFromId(), and setMessageStack().

◆ $skin

ilSystemStyleSkinContainer::$skin

protected

Definition at line 31 of file class.ilSystemStyleSkinContainer.php.

Referenced by __construct(), getSkin(), and setSkin().

◆ $system_styles_conf

ilSystemStyleSkinContainer::$system_styles_conf

protected

Definition at line 45 of file class.ilSystemStyleSkinContainer.php.

Referenced by __construct(), generateFromId(), getSystemStylesConf(), and setSystemStylesConf().

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

Services/Style/System/classes/Utilities/class.ilSystemStyleSkinContainer.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addStyle()

◆ changeResourceDirectory()

◆ changeVariablesImport()

◆ compileLess()

◆ copy()

◆ copyCSSFromDefault()

◆ copyVariablesFromDefault()

◆ create()

◆ createLessStructure()

◆ createMainLessFile()

◆ createResourceDirectory()

◆ createTempZip()

◆ delete()

◆ deleteFile()

◆ deleteStyle()

◆ export()

◆ generateFromId()

◆ getCSSFilePath()

◆ getImagesSkinPath()

◆ getLessFilePath()

◆ getLessMainFileDefautContent()

◆ getLessVariablesFilePath()

◆ getLessVariablesName()

◆ getMessageStack()

◆ getSkin()

◆ getSkinDirectory()

◆ getSystemStylesConf()

◆ import()

◆ move()

◆ recursiveRemoveDir()

◆ removeResourceDirectory()

◆ resetImages()

◆ resourcesStyleReferences()

◆ setMessageStack()

◆ setSkin()

◆ setSystemStylesConf()

◆ updateSkin()

◆ updateStyle()

◆ writeSkinToXML()

◆ xCopy()

Field Documentation

◆ $lng

◆ $message_stack

◆ $skin

◆ $system_styles_conf