BxBaseVote.php 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365
  1. <?php defined('BX_DOL') or die('hack attempt');
  2. /**
  3. * Copyright (c) UNA, Inc - https://una.io
  4. * MIT License - https://opensource.org/licenses/MIT
  5. *
  6. * @defgroup UnaBaseView UNA Base Representation Classes
  7. * @{
  8. */
  9. /**
  10. * @see BxDolVote
  11. */
  12. class BxBaseVote extends BxDolVote
  13. {
  14. protected $_bCssJsAdded;
  15. protected $_sJsClsName;
  16. protected $_sJsObjName;
  17. protected $_sStylePrefix;
  18. protected $_aHtmlIds;
  19. protected $_sTmplNameLegend;
  20. protected $_sTmplNameByList;
  21. public function __construct($sSystem, $iId, $iInit = true, $oTemplate = false)
  22. {
  23. parent::__construct($sSystem, $iId, $iInit, $oTemplate);
  24. $this->_aElementDefaults = [];
  25. $this->_aElementDefaultsApi = [];
  26. $this->_aElementParamsApi = ['is_voted'];
  27. $this->_bCssJsAdded = false;
  28. $this->_sStylePrefix = 'bx-vote';
  29. $this->_sJsClsName = 'BxDolVote';
  30. $this->_sJsObjName = 'oVote' . bx_gen_method_name($sSystem, array('_' , '-')) . $iId;
  31. $sHtmlId = str_replace(array('_' , ' '), array('-', '-'), $sSystem) . '-' . $iId;
  32. $this->_aHtmlIds = array(
  33. 'counter' => 'bx-vote-counter-' . $sHtmlId,
  34. 'by_popup' => 'bx-vote-by-popup-' . $sHtmlId
  35. );
  36. $this->_sTmplNameLegend = 'vote_legend.html';
  37. $this->_sTmplNameByList = 'vote_by_list.html';
  38. $this->_sTmplContentElementBlock = $this->_oTemplate->getHtml('vote_element_block.html');
  39. $this->_sTmplContentElementInline = $this->_oTemplate->getHtml('vote_element_inline.html');
  40. $this->_sTmplContentCounter = $this->_oTemplate->getHtml('vote_counter.html');
  41. }
  42. public function getJsClassName()
  43. {
  44. return $this->_sJsClsName;
  45. }
  46. public function getJsObjectName()
  47. {
  48. return $this->_sJsObjName;
  49. }
  50. public function getJsScript($aParams = [])
  51. {
  52. $sJsObjName = $this->getJsObjectName();
  53. $sJsObjClass = $this->getJsClassName();
  54. $bDynamicMode = isset($aParams['dynamic_mode']) && (bool)$aParams['dynamic_mode'] === true;
  55. $sCode = "if(window['" . $sJsObjName . "'] == undefined) var " . $sJsObjName . " = new " . $sJsObjClass . "(" . json_encode($this->_prepareParamsData([
  56. 'sSocket' => $this->getSocketName(),
  57. 'aRequestParams' => $this->_prepareRequestParamsData($aParams)
  58. ])) . ");";
  59. return $this->_oTemplate->_wrapInTagJsCode($sCode);
  60. }
  61. public function getJsClick($iValue = 0)
  62. {
  63. return $this->getJsObjectName() . '.vote(this, ' . $iValue . ')';
  64. }
  65. public function getJsClickCounter($aParams = array())
  66. {
  67. return $this->getJsObjectName() . '.toggleByPopup(this)';
  68. }
  69. public function getCounter($aParams = [])
  70. {
  71. $aParams = array_merge($this->_aElementDefaults, $aParams);
  72. $bDynamicMode = isset($aParams['dynamic_mode']) && (bool)$aParams['dynamic_mode'] === true;
  73. $bShowEmpty = isset($aParams['show_counter_empty']) && (bool)$aParams['show_counter_empty'] === true;
  74. $bShowActive = $this->isAllowedVoteViewVoters() && (!isset($aParams['show_counter_active']) || (bool)$aParams['show_counter_active'] === true);
  75. $bShowScript = !isset($aParams['show_script']) || (bool)$aParams['show_script'] === true;
  76. $sClass = 'sys-action-counter';
  77. if(isset($aParams['show_counter_only']) && (bool)$aParams['show_counter_only'] === true)
  78. $sClass .= ' sys-ac-only';
  79. $sClass .= ' ' .$this->_sStylePrefix . '-counter ' . $this->_sStylePrefix . '-counter-' . $this->_sType;
  80. if(!empty($aParams['class_counter']))
  81. $sClass .= $aParams['class_counter'];
  82. $aTmplVarsAttrs = array();
  83. if($bShowActive)
  84. $aTmplVarsAttrs = array_merge($aTmplVarsAttrs, array(
  85. array('key' => 'href', 'value' => 'javascript:void(0)'),
  86. array('key' => 'title', 'value' => bx_html_attribute($this->_getTitleDoBy($aParams))),
  87. array('key' => 'onclick', 'value' => 'javascript:' . $this->getJsClickCounter($aParams))
  88. ));
  89. $sHtmlId = isset($aParams['id_counter']) ? $aParams['id_counter'] : $this->_aHtmlIds['counter'];
  90. if(!empty($sHtmlId))
  91. $aTmplVarsAttrs[] = array('key' => 'id', 'value' => $sHtmlId);
  92. $aVote = !empty($aParams['vote']) && is_array($aParams['vote']) ? $aParams['vote'] : $this->_getVote();
  93. $sContent = $bShowEmpty || (int)$aVote['count'] > 0 ? $this->_getCounterLabel($aVote['count'], $aParams) : '';
  94. return $this->_oTemplate->parseHtmlByContent($this->_getTmplContentCounter(), [
  95. 'bx_if:show_text' => [
  96. 'condition' => !$bShowActive,
  97. 'content' => [
  98. 'class' => $sClass,
  99. 'bx_repeat:attrs' => $aTmplVarsAttrs,
  100. 'content' => $sContent
  101. ]
  102. ],
  103. 'bx_if:show_link' => [
  104. 'condition' => $bShowActive,
  105. 'content' => [
  106. 'class' => $sClass,
  107. 'bx_repeat:attrs' => $aTmplVarsAttrs,
  108. 'content' => $sContent
  109. ]
  110. ],
  111. 'class' => $sClass,
  112. 'bx_repeat:attrs' => $aTmplVarsAttrs,
  113. 'content' => $sContent,
  114. 'script' => $bShowScript ? $this->getJsScript($aParams) : ''
  115. ]);
  116. }
  117. public function getLegend($aParams = array())
  118. {
  119. return '';
  120. }
  121. public function getElementBlock($aParams = array())
  122. {
  123. $aParams['usage'] = BX_DOL_VOTE_USAGE_BLOCK;
  124. return $this->getElement($aParams);
  125. }
  126. public function getElementInline($aParams = array())
  127. {
  128. $aParams['usage'] = BX_DOL_VOTE_USAGE_INLINE;
  129. return $this->getElement($aParams);
  130. }
  131. public function getElement($aParams = array())
  132. {
  133. $sMethod = '_getTmplContentElement' . bx_gen_method_name(!empty($aParams['usage']) ? $aParams['usage'] : BX_DOL_VOTE_USAGE_DEFAULT);
  134. if(!method_exists($this, $sMethod))
  135. return '';
  136. $aTmplVars = $this->_getTmplVarsElement($aParams);
  137. if(empty($aTmplVars) || !is_array($aTmplVars))
  138. return '';
  139. return $this->_oTemplate->parseHtmlByContent($this->$sMethod(), $aTmplVars);
  140. }
  141. public function getElementAPI($aParams = [])
  142. {
  143. if(!($this->_bApi = bx_is_api()))
  144. return;
  145. if(!$this->isEnabled())
  146. return bx_api_get_msg('_vote_err_not_enabled');
  147. $aParams = array_merge($this->_aElementDefaultsApi, $aParams);
  148. $iObjectId = $this->getId();
  149. $iAuthorId = $this->_getAuthorId();
  150. $bCount = $this->_isCount();
  151. $isAllowedVote = $this->isAllowedVote();
  152. $isAllowedVoteView = $this->isAllowedVoteView();
  153. $aParams['is_voted'] = $this->isPerformed($iObjectId, $iAuthorId);
  154. $aParams['track'] = $aParams['is_voted'] ? $this->_getTrack($iObjectId, $iAuthorId) : array();
  155. //--- Do Vote
  156. $bDoVote = $this->_isShowDoVote($aParams, $isAllowedVote, $bCount);
  157. $aDoVote = $bDoVote ? $this->_getDoVote($aParams, $isAllowedVote) : [];
  158. //--- Counter
  159. $bCounter = $this->_isShowCounter($aParams, $isAllowedVote, $isAllowedVoteView, $bCount);
  160. $aCounter = $bCounter ? $this->getCounterAPI(array_merge($aParams, [
  161. 'show_counter_only' => false,
  162. 'show_script' => false
  163. ])) : [];
  164. if(!$bDoVote && !$bCounter)
  165. return bx_api_get_msg('');
  166. return [
  167. 'type' => $this->_sType,
  168. 'system' => $this->_sSystem,
  169. 'object_id' => $this->_iId,
  170. 'params' => array_intersect_key($aParams, array_flip($this->_aElementParamsApi)),
  171. 'action' => $aDoVote,
  172. 'counter' => $aCounter
  173. ];
  174. }
  175. /**
  176. * Internal methods.
  177. */
  178. protected function _prepareParamsData($aParams)
  179. {
  180. return parent::_prepareParamsData(array_merge([
  181. 'sObjName' => $this->getJsObjectName(),
  182. 'sStylePrefix' => $this->_sStylePrefix,
  183. 'aHtmlIds' => $this->_aHtmlIds,
  184. ], $aParams));
  185. }
  186. /*
  187. * This method should be overwritten by subclass.
  188. */
  189. protected function _getTmplVarsElement($aParams = array())
  190. {
  191. $aParams = array_merge($this->_aElementDefaults, $aParams);
  192. $bDynamicMode = isset($aParams['dynamic_mode']) && (bool)$aParams['dynamic_mode'] === true;
  193. $bShowCounterEmpty = isset($aParams['show_counter_empty']) && (bool)$aParams['show_counter_empty'] === true;
  194. $iObjectId = $this->getId();
  195. $iAuthorId = $this->_getAuthorId();
  196. $bCount = $this->_isCount();
  197. $isAllowedVote = $this->isAllowedVote();
  198. $isAllowedVoteView = $this->isAllowedVoteView();
  199. $aParams['is_voted'] = $this->isPerformed($iObjectId, $iAuthorId);
  200. $aParams['track'] = $aParams['is_voted'] ? $this->_getTrack($iObjectId, $iAuthorId) : array();
  201. //--- Do Vote
  202. $bTmplVarsDoVote = $this->_isShowDoVote($aParams, $isAllowedVote, $bCount);
  203. $aTmplVarsDoVote = array();
  204. if($bTmplVarsDoVote)
  205. $aTmplVarsDoVote = array(
  206. 'style_prefix' => $this->_sStylePrefix,
  207. 'do_vote' => $this->_getDoVote($aParams, $isAllowedVote),
  208. );
  209. //--- Counter
  210. $bTmplVarsCounter = $this->_isShowCounter($aParams, $isAllowedVote, $isAllowedVoteView, $bCount);
  211. $aTmplVarsCounter = array();
  212. if($bTmplVarsCounter)
  213. $aTmplVarsCounter = array(
  214. 'style_prefix' => $this->_sStylePrefix,
  215. 'bx_if:show_hidden' => array(
  216. 'condition' => !$bCount && !$bShowCounterEmpty,
  217. 'content' => array()
  218. ),
  219. 'counter' => $this->getCounter(array_merge($aParams, [
  220. 'show_counter_only' => false,
  221. 'show_script' => false
  222. ]))
  223. );
  224. //--- Legend
  225. $bTmplVarsLegend = $this->_isShowLegend($aParams, $isAllowedVote, $isAllowedVoteView, $bCount);
  226. $aTmplVarsLegend = array();
  227. if($bTmplVarsLegend)
  228. $aTmplVarsLegend = array(
  229. 'legend' => $this->getLegend($aParams)
  230. );
  231. if(!$bTmplVarsDoVote && !$bTmplVarsCounter && !$bTmplVarsLegend)
  232. return array();
  233. $sClass = $this->_sStylePrefix . '-' . $this->_sType;
  234. if(!empty($aParams['class_element']))
  235. $sClass .= $aParams['class_element'];
  236. return array(
  237. 'style_prefix' => $this->_sStylePrefix,
  238. 'html_id' => $this->_aHtmlIds['main'],
  239. 'class' => $sClass . ' ' . $this->_aHtmlIds['main'],
  240. 'bx_if:show_vote_data' => array(
  241. 'condition' => false,
  242. 'content' => array()
  243. ),
  244. 'bx_if:show_do_vote' => array(
  245. 'condition' => $bTmplVarsDoVote,
  246. 'content' => $aTmplVarsDoVote
  247. ),
  248. 'bx_if:show_counter' => array(
  249. 'condition' => $bTmplVarsCounter,
  250. 'content' => $aTmplVarsCounter
  251. ),
  252. 'bx_if:show_legend' => array(
  253. 'condition' => $bTmplVarsLegend,
  254. 'content' => $aTmplVarsLegend
  255. ),
  256. 'script' => $this->getJsScript($aParams)
  257. );
  258. }
  259. protected function _getDoVote($aParams = array(), $isAllowedVote = true)
  260. {
  261. return $this->_bApi ? [] : '';
  262. }
  263. protected function _getCounterLabel($iCount, $aParams = array())
  264. {
  265. return _t(isset($aParams['caption']) ? $aParams['caption'] : '_vote_counter', $iCount);
  266. }
  267. protected function _getVotedBy($aParams = array())
  268. {
  269. $aTmplUsers = array();
  270. $aUserIds = $this->_oQuery->getPerformedBy($this->getId());
  271. foreach($aUserIds as $iUserId) {
  272. list($sUserName, $sUserUrl, $sUserIcon, $sUserUnit) = $this->_getAuthorInfo($iUserId);
  273. $aTmplUsers[] = array(
  274. 'style_prefix' => $this->_sStylePrefix,
  275. 'user_unit' => $sUserUnit
  276. );
  277. }
  278. if(empty($aTmplUsers))
  279. $aTmplUsers = MsgBox(_t('_Empty'));
  280. return $this->_oTemplate->parseHtmlByName($this->_sTmplNameByList, array(
  281. 'style_prefix' => $this->_sStylePrefix,
  282. 'class' => '',
  283. 'bx_repeat:list' => $aTmplUsers
  284. ));
  285. }
  286. protected function _isShowDoVote($aParams, $isAllowedVote, $bCount)
  287. {
  288. return !isset($aParams['show_do_vote']) || (bool)$aParams['show_do_vote'] === true;
  289. }
  290. protected function _isShowCounter($aParams, $isAllowedVote, $isAllowedVoteView, $bCount)
  291. {
  292. return isset($aParams['show_counter']) && (bool)$aParams['show_counter'] === true && $isAllowedVoteView && ($isAllowedVote || $bCount);
  293. }
  294. protected function _isShowLegend($aParams, $isAllowedVote, $isAllowedVoteView, $bCount)
  295. {
  296. return false;
  297. }
  298. }
  299. /** @} */