SurveyAdmin

Extends \Survey_Common_Action

survey

This controller contains common functions for survey related views.

package

LimeSurvey

author

The LimeSurvey Project team

copyright

2011

version

$Id: surveyaction.php 12301 2012-02-02 08:51:43Z c_schmitz $

access

public

Methods

__construct

__construct($controller = null, $id = null) 
inherited

Arguments

$controller

$id

Loads list of surveys and its few quick properties.

index() : void
access

public

Delete multiple survey

deleteMultiple() : void

listsurveys

listsurveys() 

regenquestioncodes

regenquestioncodes($iSurveyID, $sSubAction) 

Arguments

$iSurveyID

$sSubAction

This function prepares the view for a new survey

newsurvey() 

fakebrowser

fakebrowser() 

This function prepares the view for editing a survey

editsurveysettings($iSurveyID) 

Arguments

$iSurveyID

Function responsible to import survey resources from a '.zip' file.

importsurveyresources() : void
access

public

changetemplate

changetemplate($iSurveyID, $template) 

Arguments

$iSurveyID

$template

togglequickaction

togglequickaction() 

Load complete view of survey properties and actions specified by $iSurveyID

view(mixed $iSurveyID, mixed $gid = null, mixed $qid = null) : void
access

public

Arguments

$iSurveyID

mixed

$gid

mixed

$qid

mixed

Ajaxified get questiongroup with containing questions

getAjaxQuestionGroupArray($surveyid) 

Arguments

$surveyid

Ajaxified get MenuItems with containing questions

getAjaxMenuArray($surveyid, $position = '') 

Arguments

$surveyid

$position

Load list question groups view for a specified by $iSurveyID

listquestiongroups(mixed $surveyid) : void
access

public

Arguments

$surveyid

mixed

The survey ID

Load list questions view for a specified survey by $surveyid

listquestions(mixed $surveyid) : string
access

public

Arguments

$surveyid

mixed

Response

string

Function responsible to deactivate a survey.

deactivate(int $iSurveyID = null) : void
access

public

Arguments

$iSurveyID

int

Function responsible to activate survey.

activate(int $iSurveyID) : void
access

public

Arguments

$iSurveyID

int

Function responsible to delete a survey.

delete(int $iSurveyID) : string
access

public

Arguments

$iSurveyID

int

Response

string

Remove files not deleted properly.

purge(int $purge_sid) : void

Purge is only available for surveys that were already deleted but for some reason left files behind.

Arguments

$purge_sid

int

Takes the edit call from the detailed survey view, which either deletes the survey information

editSurvey_json() 

Edit surveytexts and general settings

surveygeneralsettings($iSurveyID) 

Arguments

$iSurveyID

Load editing of local settings of a survey screen.

editlocalsettings(int $iSurveyID) : void
access

public

Arguments

$iSurveyID

int

Function responsible to import/copy a survey based on $action.

copy() : void
access

public

questiongroup::organize() Load ordering of question group screen.

organize(int $iSurveyID) : void

Arguments

$iSurveyID

int

Called via ajax request from survey summary quick action "Show questions group by group"

changeFormat($iSurveyID, $format) 

Arguments

$iSurveyID

$format

Show the form for Organize question groups/questions

_showReorderForm(int $iSurveyID) : void
todo

Change function name to _showOrganizeGroupsAndQuestions?

Arguments

$iSurveyID

int

Reorder groups and questions

_reorderGroup(int $iSurveyID) : void

Arguments

$iSurveyID

int

Get the new question organization from the post data.

getOrgdata() : array

This function replaces parse_str, since parse_str is bound by max_input_vars.

Response

array

survey::_fetchSurveyInfo() Load survey information based on $action.

_fetchSurveyInfo(string $action, mixed $iSurveyID = null) 
deprecated

use Survey objects instead

Arguments

$action

string

$iSurveyID

mixed

survey::_generalTabNewSurvey() Load "General" tab of new survey screen.

_generalTabNewSurvey() 

_getGeneralTemplateData

_getGeneralTemplateData(integer $iSurveyID) 

Arguments

$iSurveyID

integer

_getTextEditData

_getTextEditData(\Survey $survey) : array

Arguments

$survey

\Survey

Response

array

survey::_generalTabEditSurvey() Load "General" tab of edit survey screen.

_generalTabEditSurvey(\Survey $survey) : mixed

Arguments

$survey

\Survey

Response

mixed

survey::_generalTabEditSurvey() Load "General" tab of edit survey screen.

_pluginTabSurvey(\Survey $survey) : mixed

Arguments

$survey

\Survey

Response

mixed

survey::_tabPresentationNavigation() Load "Presentation & navigation" tab.

_tabPresentationNavigation(mixed $esrow) : array

Arguments

$esrow

mixed

Response

array

survey::_tabPublicationAccess() Load "Publication * access control" tab.

_tabPublicationAccess(\Survey $survey) 

Arguments

$survey

\Survey

survey::_tabNotificationDataManagement() Load "Notification & data management" tab.

_tabNotificationDataManagement(mixed $esrow) : array

Arguments

$esrow

mixed

Response

array

survey::_tabTokens() Load "Tokens" tab.

_tabTokens(mixed $esrow) : array

Arguments

$esrow

mixed

Response

array

_tabPanelIntegration

_tabPanelIntegration(\Survey $survey) : array

Arguments

$survey

\Survey

Response

array

survey::_tabResourceManagement() Load "Resources" tab.

_tabResourceManagement(\Survey $survey) : mixed

Arguments

$survey

\Survey

survey

Response

mixed

expire

expire($iSurveyID) 

Arguments

$iSurveyID

datetimesettings

datetimesettings() 

Action to set expiry date to multiple surveys

expireMultipleSurveys() 

getUrlParamsJSON

getUrlParamsJSON($iSurveyID) 

Arguments

$iSurveyID

Executes registerScriptFile for all needed script/style files

_registerScriptFiles() : void

Saves the new survey after the creation screen is submitted

insert(integer $iSurveyID = null) : string

Arguments

$iSurveyID

integer

The survey id to be used for the new survey. If already taken a new random one will be used.

Response

string

This private function creates a sample group

_createSampleGroup(integer $iSurveyID) 

Arguments

$iSurveyID

integer

The survey ID that the sample group will belong to

This private function creates a sample question

_createSampleQuestion(integer $iSurveyID, mixed $iGroupID) 

Arguments

$iSurveyID

integer

The survey ID that the sample question will belong to

$iGroupID

mixed

The group ID that the sample question will belong to

Renders template(s) wrapped in header and footer

_renderWrappedTemplate(string $sAction = '', array|string $aViewUrls = array(), array $aData = array(), string|boolean $sRenderFile = false) 
inherited

Addition of parameters should be avoided if they can be added to $aData

NOTE FROM LOUIS : We want to remove this function, wich doesn't respect MVC pattern. The work it's doing should be handle by layout files, and subviews inside views. Eg : for route "admin/survey/sa/listquestiongroups/surveyid/282267" the Group controller should use a main layout (with admin menu bar as a widget), then render the list view, in wich the question group bar is called as a subview.

So for now, we try to evacuate all the renderWrappedTemplate logic (if statements, etc.) to subfunctions, then it will be easier to remove. Comments starting with //// indicate how it should work in the future

Arguments

$sAction

string

Current action, the folder to fetch views from

$aViewUrls

array|string

View url(s)

$aData

array

Data to be passed on. Optional.

$sRenderFile

string|boolean

File to be rendered as a layout. Optional.

Override runWithParams() implementation in CAction to help us parse requests with subactions.

runWithParams(array $params) : bool
inherited

Arguments

$params

array

URL Parameters

Response

bool

Some functions have different parameters, which are just an alias of the usual parameters we're getting in the url. This function just populates those variables so that we don't end up in an error.

_addPseudoParams(array $params) : array
inherited

This is also used while rendering wrapped template {@link Survey_Common_Action::_renderWrappedTemplate()}

throws

Arguments

$params

array

Parameters to parse and populate

Response

array

Populated parameters

Action classes require them to have a run method. We reroute it to index if called.

run() 
inherited

Routes the action into correct subaction

route(string $sa, string[] $get_vars) : mixed
inherited
access

protected

Arguments

$sa

string

$get_vars

string[]

Response

mixed

renderInternal

renderInternal(string $_viewFile_, $_data_ = null, $_return_ = false) 
inherited
inheritdoc

Arguments

$_viewFile_

string

$_data_

$_return_

Rendering the subviews and views of _renderWrappedTemplate

renderCentralContents(string $sAction, array|string $aViewUrls, array $aData = array()) : string
inherited

Arguments

$sAction

string

$aViewUrls

array|string

$aData

array

Response

string

Display the update notification

_updatenotification() 
inherited

Display notifications

_notifications() 
inherited

Survey summary

_nsurveysummary(array $aData) 
inherited

Arguments

$aData

array

Header

_showHeaders(array $aData) 
inherited

Arguments

$aData

array

_showadminmenu() function returns html text for the administration button bar

_showadminmenu(mixed $aData) : string
inherited
access

public

global

string $homedir

string $scriptname

string $surveyid

string $setfont

string $imageurl

int $surveyid

Arguments

$aData

mixed

Response

string

_titlebar

_titlebar($aData) 
inherited

Arguments

$aData

_tokenbar

_tokenbar($aData) 
inherited

Arguments

$aData

Render the save/cancel bar for Organize question groups/questions

_organizequestionbar(array $aData) 
inherited
since 2014-09-30
author

Olle Haerstedt

Arguments

$aData

array

Shows admin menu for question

_questionbar(array $aData) 
inherited

Arguments

$aData

array

Show admin menu for question group view

_nquestiongroupbar(array $aData) 
inherited

Arguments

$aData

array

?

_fullpagebar

_fullpagebar($aData) 
inherited

Arguments

$aData

Shows admin menu for surveys

_surveybar($aData) 
inherited

Arguments

$aData

Show side menu for survey view

_surveysidemenu(array $aData) 
inherited

Arguments

$aData

array

all the needed data

Render the quick-menu that is shown when side-menu is hidden.

renderQuickmenu(array $aData) : string
inherited

Only show home-icon for now.

Add support for plugin to attach icon elements using event afterQuickMenuLoad

todo

Make quick-menu user configurable

Arguments

$aData

array

Response

string

Returns content from event beforeSideMenuRender

beforeSideMenuRender(array $aData) : string
inherited

Arguments

$aData

array

Response

string

listquestion groups

_listquestiongroups(array $aData) 
inherited

Arguments

$aData

array

_listquestions

_listquestions($aData) 
inherited

Arguments

$aData

Show survey summary

_surveysummary(array $aData) 
inherited

Arguments

$aData

array

Browse Menu Bar

_browsemenubar(array $aData) 
inherited

Arguments

$aData

array

Load menu bar of user group controller.

_userGroupBar(array $aData) : void
inherited

Arguments

$aData

array

_filterImportedResources

_filterImportedResources(string $extractdir, string $destdir) : array
inherited

Arguments

$extractdir

string

$destdir

string

Response

array

Creates a temporary directory

_tempdir(string $dir, string $prefix = '', int $mode = 448) : string
inherited
access

protected

Arguments

$dir

string

$prefix

string

$mode

int

Response

string

Get extra menus from plugins that are using event beforeAdminMenuRender

fetchExtraMenus(array $aData) : \array<ExtraMenu>
inherited

Arguments

$aData

array

Response

\array

index

index() : void
inherited