ActionEditAlias Class Reference

Inheritance diagram for ActionEditAlias:

Collaboration diagram for ActionEditAlias:

Protected Member Functions
	createFormFields ($bearsamppWinbinder)
	deleteItem ()
	getDeleteConfirmMessage ()
	getDeleteDialogTitle ()
	getDeleteErrorMessage ()
	getDeleteSuccessMessage ()
	getDialogTitle ()
	getFormValues ($bearsamppWinbinder)
	getSaveErrorMessage ()
	getSaveSuccessMessage ($values)
	getWindowTitle ()
	handleCustomEvent ($window, $id, $ctrl, $param1, $param2)
	initializeDialog ($args)
	itemExists ($values)
	restartService ()
	saveItem ($values)
	validateInput ($values)
Protected Member Functions inherited from ActionDialogBase
	createButtons ($bearsamppWinbinder)
	getGaugeDelete ()
	getGaugeSave ()
	handleDelete ($window)
	handleSave ($window)
	isEditMode ()

Private Attributes
	$wbBtnDest
	$wbInputDest
	$wbInputName
	$wbLabelDest
	$wbLabelExp
	$wbLabelName

Additional Inherited Members
Public Member Functions inherited from ActionDialogBase
	__construct ($args)
	processWindow ($window, $id, $ctrl, $param1, $param2)
Data Fields inherited from ActionDialogBase
const	GAUGE_DELETE = 2
const	GAUGE_SAVE = 2
Protected Attributes inherited from ActionDialogBase
	$initValue
	$wbBtnCancel
	$wbBtnDelete
	$wbBtnSave
	$wbProgressBar
	$wbWindow

Detailed Description

Class ActionEditAlias Handles the editing of Apache aliases within the Bearsampp application.

Definition at line 14 of file class.action.editAlias.php.

Member Function Documentation

createFormFields()

createFormFields ( $bearsamppWinbinder )

protected

Create the form fields for the edit alias dialog.

Parameters

object

$bearsamppWinbinder

The WinBinder instance.

Returns

void

Reimplemented from ActionDialogBase.

Definition at line 102 of file class.action.editAlias.php.

    {
        global $bearsamppRoot, $bearsamppLang, $bearsamppBins;
 
        // Load existing alias data
        $filePath    = Path::getAliasPath() . '/' . $this->initValue . '.conf';
        $fileContent = file_get_contents($filePath);
        preg_match('/^Alias \/' . $this->initValue . ' "(.+)"/', $fileContent, $match);
        $initDest      = Path::formatWindowsPath($match[1]);
        $apachePortUri = $bearsamppBins->getApache()->getPort() != 80 ? ':' . $bearsamppBins->getApache()->getPort() : '';
 
        $this->wbLabelName = $bearsamppWinbinder->createLabel(
            $this->wbWindow,
            $bearsamppLang->getValue(Lang::ALIAS_NAME_LABEL) . ' :',
            15,
            15,
            85,
            null,
            WBC_RIGHT
        );
        $this->wbInputName = $bearsamppWinbinder->createInputText(
            $this->wbWindow,
            $this->initValue,
            105,
            13,
            150,
            null
        );
 
        $this->wbLabelDest = $bearsamppWinbinder->createLabel(
            $this->wbWindow,
            $bearsamppLang->getValue(Lang::ALIAS_DEST_LABEL) . ' :',
            15,
            45,
            85,
            null,
            WBC_RIGHT
        );
        $this->wbInputDest = $bearsamppWinbinder->createInputText(
            $this->wbWindow,
            $initDest,
            105,
            43,
            190,
            null,
            null,
            WBC_READONLY
        );
        $this->wbBtnDest   = $bearsamppWinbinder->createButton(
            $this->wbWindow,
            $bearsamppLang->getValue(Lang::BUTTON_BROWSE),
            300,
            43,
            110
        );
 
        $this->wbLabelExp = $bearsamppWinbinder->createLabel(
            $this->wbWindow,
            sprintf($bearsamppLang->getValue(Lang::ALIAS_EXP_LABEL), $apachePortUri, $this->initValue, $initDest),
            15,
            80,
            470,
            50
        );
    }

References $bearsamppBins, $bearsamppLang, $bearsamppRoot, Lang\ALIAS_DEST_LABEL, Lang\ALIAS_EXP_LABEL, Lang\ALIAS_NAME_LABEL, Lang\BUTTON_BROWSE, Path\formatWindowsPath(), and Path\getAliasPath().

Here is the call graph for this function:

deleteItem()

deleteItem ( )

protected

Delete the alias configuration file.

Returns

bool True on success, false on failure.

Reimplemented from ActionDialogBase.

Definition at line 250 of file class.action.editAlias.php.

    {
        global $bearsamppRoot;
 
        return @unlink(Path::getAliasPath() . '/' . $this->initValue . '.conf');
    }

References $bearsamppRoot, and Path\getAliasPath().

Here is the call graph for this function:

getDeleteConfirmMessage()

getDeleteConfirmMessage ( )

protected

Get the delete confirmation message.

Returns

string The localized confirmation message with the alias name.

Reimplemented from ActionDialogBase.

Definition at line 296 of file class.action.editAlias.php.

    {
        global $bearsamppLang;
 
        return sprintf($bearsamppLang->getValue(Lang::DELETE_ALIAS), $this->initValue);
    }

References $bearsamppLang, and Lang\DELETE_ALIAS.

getDeleteDialogTitle()

getDeleteDialogTitle ( )

protected

Get the delete dialog title.

Returns

string The localized delete dialog title.

Reimplemented from ActionDialogBase.

Definition at line 58 of file class.action.editAlias.php.

    {
        global $bearsamppLang;
 
        return $bearsamppLang->getValue(Lang::DELETE_ALIAS_TITLE);
    }

References $bearsamppLang, and Lang\DELETE_ALIAS_TITLE.

getDeleteErrorMessage()

getDeleteErrorMessage ( )

protected

Get the error message after delete failure.

Returns

string The localized error message with the file path.

Reimplemented from ActionDialogBase.

Definition at line 320 of file class.action.editAlias.php.

    {
        global $bearsamppRoot, $bearsamppLang;
 
        return sprintf(
            $bearsamppLang->getValue(Lang::ALIAS_REMOVE_ERROR),
            Path::getAliasPath() . '/' . $this->initValue . '.conf'
        );
    }

References $bearsamppLang, $bearsamppRoot, Lang\ALIAS_REMOVE_ERROR, and Path\getAliasPath().

Here is the call graph for this function:

getDeleteSuccessMessage()

getDeleteSuccessMessage ( )

protected

Get the success message after delete.

Returns

string The localized success message with the alias name.

Reimplemented from ActionDialogBase.

Definition at line 308 of file class.action.editAlias.php.

    {
        global $bearsamppLang;
 
        return sprintf($bearsamppLang->getValue(Lang::ALIAS_REMOVED), $this->initValue);
    }

References $bearsamppLang, and Lang\ALIAS_REMOVED.

getDialogTitle()

getDialogTitle ( )

protected

Get the dialog title for message boxes.

Returns

string The localized dialog title.

Reimplemented from ActionDialogBase.

Definition at line 46 of file class.action.editAlias.php.

    {
        global $bearsamppLang;
 
        return $bearsamppLang->getValue(Lang::ADD_ALIAS_TITLE);
    }

References $bearsamppLang, and Lang\ADD_ALIAS_TITLE.

getFormValues()

getFormValues ( $bearsamppWinbinder )

protected

Get the current form values from the input controls.

Parameters

object

$bearsamppWinbinder

The WinBinder instance.

Returns

array Associative array with 'name' and 'dest' keys.

Reimplemented from ActionDialogBase.

Definition at line 175 of file class.action.editAlias.php.

    {
        return [
            'name' => $bearsamppWinbinder->getText($this->wbInputName[WinBinder::CTRL_OBJ]),
            'dest' => $bearsamppWinbinder->getText($this->wbInputDest[WinBinder::CTRL_OBJ])
        ];
    }

References WinBinder\CTRL_OBJ.

getSaveErrorMessage()

getSaveErrorMessage ( )

protected

Get the error message after save failure.

Returns

string The localized error message.

Reimplemented from ActionDialogBase.

Definition at line 284 of file class.action.editAlias.php.

    {
        global $bearsamppLang;
 
        return $bearsamppLang->getValue(Lang::ALIAS_CREATED_ERROR);
    }

References $bearsamppLang, and Lang\ALIAS_CREATED_ERROR.

getSaveSuccessMessage()

getSaveSuccessMessage ( $values )

protected

Get the success message after saving.

Parameters

array

$values

The form values.

Returns

string The localized success message.

Reimplemented from ActionDialogBase.

Definition at line 264 of file class.action.editAlias.php.

    {
        global $bearsamppLang, $bearsamppBins;
 
        $apachePortUri = $bearsamppBins->getApache()->getPort() != 80 ? ':' . $bearsamppBins->getApache()->getPort() : '';
 
        return sprintf(
            $bearsamppLang->getValue(Lang::ALIAS_CREATED),
            $values['name'],
            $apachePortUri,
            $values['name'],
            $values['dest']
        );
    }

References $bearsamppBins, $bearsamppLang, and Lang\ALIAS_CREATED.

getWindowTitle()

getWindowTitle ( )

protected

Get the dialog window title.

Returns

string The localized window title with the alias name.

Reimplemented from ActionDialogBase.

Definition at line 34 of file class.action.editAlias.php.

    {
        global $bearsamppLang;
 
        return sprintf($bearsamppLang->getValue(Lang::EDIT_ALIAS_TITLE), $this->initValue);
    }

References $bearsamppLang, and Lang\EDIT_ALIAS_TITLE.

handleCustomEvent()

handleCustomEvent ( $window, $id, $ctrl, $param1, $param2 )

protected

Handle custom window events (name input change and browse button).

Parameters

resource	$window	The window resource.
int	$id	The control ID.
resource	$ctrl	The control resource.
mixed	$param1	Additional parameter 1.
mixed	$param2	Additional parameter 2.

Returns

void

Reimplemented from ActionDialogBase.

Definition at line 352 of file class.action.editAlias.php.

    {
        global $bearsamppLang, $bearsamppBins, $bearsamppWinbinder;
 
        $apachePortUri = $bearsamppBins->getApache()->getPort() != 80 ? ':' . $bearsamppBins->getApache()->getPort() : '';
        $aliasName     = $bearsamppWinbinder->getText($this->wbInputName[WinBinder::CTRL_OBJ]);
        $aliasDest     = $bearsamppWinbinder->getText($this->wbInputDest[WinBinder::CTRL_OBJ]);
 
        // Handle name input change
        if ($id == $this->wbInputName[WinBinder::CTRL_ID]) {
            $bearsamppWinbinder->setText(
                $this->wbLabelExp[WinBinder::CTRL_OBJ],
                sprintf($bearsamppLang->getValue(Lang::ALIAS_EXP_LABEL), $apachePortUri, $aliasName, $aliasDest)
            );
            $bearsamppWinbinder->setEnabled(
                $this->wbBtnSave[WinBinder::CTRL_OBJ],
                !empty($aliasName)
            );
        }
 
        // Handle browse button
        if ($id == $this->wbBtnDest[WinBinder::CTRL_ID]) {
            $aliasDest = $bearsamppWinbinder->sysDlgPath(
                $window,
                $bearsamppLang->getValue(Lang::ALIAS_DEST_PATH),
                $aliasDest
            );
            if ($aliasDest && is_dir($aliasDest)) {
                $bearsamppWinbinder->setText($this->wbInputDest[WinBinder::CTRL_OBJ], $aliasDest . '\\');
                $bearsamppWinbinder->setText(
                    $this->wbLabelExp[WinBinder::CTRL_OBJ],
                    sprintf($bearsamppLang->getValue(Lang::ALIAS_EXP_LABEL), $apachePortUri, $aliasName, $aliasDest . '\\')
                );
            }
        }
    }

References $bearsamppBins, $bearsamppLang, Lang\ALIAS_DEST_PATH, Lang\ALIAS_EXP_LABEL, WinBinder\CTRL_ID, and WinBinder\CTRL_OBJ.

initializeDialog()

initializeDialog ( $args )

protected

Initialize the dialog by loading the existing alias configuration.

Parameters

array

$args

Command line arguments where $args[0] is the alias name.

Returns

bool True if initialization successful, false otherwise.

Reimplemented from ActionDialogBase.

Definition at line 72 of file class.action.editAlias.php.

    {
        global $bearsamppRoot;
 
        if (!isset($args[0]) || empty($args[0])) {
            return false;
        }
 
        $filePath = Path::getAliasPath() . '/' . $args[0] . '.conf';
        if (!file_exists($filePath)) {
            return false;
        }
 
        $fileContent = file_get_contents($filePath);
        if (!preg_match('/^Alias \/' . $args[0] . ' "(.+)"/', $fileContent, $match)) {
            return false;
        }
 
        $this->initValue = $args[0];
 
        return true;
    }

References $bearsamppRoot, and Path\getAliasPath().

Here is the call graph for this function:

itemExists()

itemExists ( $values )

protected

Check if a different alias with the same name already exists.

Parameters

array

$values

The form values.

Returns

bool True if a conflicting alias exists, false otherwise.

Reimplemented from ActionDialogBase.

Definition at line 211 of file class.action.editAlias.php.

    {
        global $bearsamppRoot, $bearsamppLang, $bearsamppWinbinder;
 
        // Only check if name changed
        if ($values['name'] != $this->initValue && is_file(Path::getAliasPath() . '/' . $values['name'] . '.conf')) {
            $bearsamppWinbinder->messageBoxError(
                sprintf($bearsamppLang->getValue(Lang::ALIAS_ALREADY_EXISTS), $values['name']),
                $this->getDialogTitle()
            );
 
            return true;
        }
 
        return false;
    }

References $bearsamppLang, $bearsamppRoot, Lang\ALIAS_ALREADY_EXISTS, and Path\getAliasPath().

Here is the call graph for this function:

restartService()

restartService ( )

protected

Restart the Apache service after saving or deleting.

Returns

void

Reimplemented from ActionDialogBase.

Definition at line 335 of file class.action.editAlias.php.

    {
        global $bearsamppBins;
        $bearsamppBins->getApache()->getService()->restart();
    }

References $bearsamppBins.

saveItem()

saveItem ( $values )

protected

Save the alias configuration file.

Parameters

array

$values

The form values.

Returns

bool True on success, false on failure.

Reimplemented from ActionDialogBase.

Definition at line 235 of file class.action.editAlias.php.

    {
        global $bearsamppRoot, $bearsamppBins;
 
        return file_put_contents(
                Path::getAliasPath() . '/' . $values['name'] . '.conf',
                $bearsamppBins->getApache()->getAliasContent($values['name'], $values['dest'])
            ) !== false;
    }

References $bearsamppBins, $bearsamppRoot, and Path\getAliasPath().

Here is the call graph for this function:

validateInput()

validateInput ( $values )

protected

Validate the form input.

Parameters

array

$values

The form values.

Returns

array ['valid' => bool, 'error' => string|null]

Reimplemented from ActionDialogBase.

Definition at line 190 of file class.action.editAlias.php.

    {
        global $bearsamppLang;
 
        if (!ctype_alnum($values['name'])) {
            return [
                'valid' => false,
                'error' => sprintf($bearsamppLang->getValue(Lang::ALIAS_NOT_VALID_ALPHA), $values['name'])
            ];
        }
 
        return ['valid' => true];
    }

References $bearsamppLang, and Lang\ALIAS_NOT_VALID_ALPHA.

Field Documentation

$wbBtnDest

$wbBtnDest

private

Definition at line 25 of file class.action.editAlias.php.

$wbInputDest

$wbInputDest

private

Definition at line 23 of file class.action.editAlias.php.

$wbInputName

$wbInputName

private

Definition at line 19 of file class.action.editAlias.php.

$wbLabelDest

$wbLabelDest

private

Definition at line 21 of file class.action.editAlias.php.

$wbLabelExp

$wbLabelExp

private

Definition at line 27 of file class.action.editAlias.php.

$wbLabelName

$wbLabelName

private

Definition at line 17 of file class.action.editAlias.php.

---

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

• E:/Bearsampp-development/sandbox/core/classes/actions/class.action.editAlias.php