208 lines
22 KiB
HTML
208 lines
22 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="en">
|
||
|
||
<head>
|
||
<title>Custom widgets</title>
|
||
<meta name="generator" content="Help+Manual" />
|
||
<meta name="keywords" content="" />
|
||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
||
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
<meta name="description" content="Users who are members of the Administrators group can create and publish such widgets. By creating a custom widget, you can:" />
|
||
<meta name="picture" content="" />
|
||
<meta property="og:type" content="website" />
|
||
<meta property="og:title" content="Full documentation for BRIX365 platform. Low-code developer guide. User guide. Admin guide. Developer guide." />
|
||
<meta property="og:url" content="https://brix365.com/en/help" />
|
||
<meta property="og:image" content="" />
|
||
<link rel="icon" href="favicon.png" type="image/png" />
|
||
|
||
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet" />
|
||
<link rel="stylesheet" href="./jquery-ui.min.css" />
|
||
<link rel="stylesheet" href="default.css" />
|
||
<link rel="stylesheet" href="./search-yandex.css" />
|
||
<link rel="stylesheet" href="./article.css" />
|
||
<link rel="stylesheet" href="./glossary.css" />
|
||
<link rel="stylesheet" href="./theme.css" />
|
||
<script type="text/javascript" src="jquery.js"></script>
|
||
<script type="text/javascript" src="helpman_settings.js"></script>
|
||
<script type="text/javascript" src="helpman_topicinit.js"></script>
|
||
|
||
<script type="text/javascript" src="highlight.js"></script>
|
||
<script type="text/javascript">
|
||
$(document).ready(function(){highlight();});
|
||
</script>
|
||
</head>
|
||
|
||
<body>
|
||
|
||
<script>!function(e,t,c,n,r,a,m){e.ym=e.ym||function(){(e.ym.a=e.ym.a||[]).push(arguments)},e.ym.l=1*new Date;for(var s=0;s<document.scripts.length;s++)if(document.scripts[s].src===n)return;a=t.createElement(c),m=t.getElementsByTagName(c)[0],a.async=1,a.src=n,m.parentNode.insertBefore(a,m)}(window,document,"script","https://mc.yandex.ru/metrika/tag.js"),ym(83179930,"init",{clickmap:!0,trackLinks:!0,accurateTrackBounce:!0,webvisor:!0})</script><noscript><div><img alt=""src=https://mc.yandex.ru/watch/83179930 style=position:absolute;left:-9999px></div></noscript>
|
||
|
||
<header class="header elma-365">
|
||
<div class="container">
|
||
<a class="header__logo" href="https://brix365.com/en/help">
|
||
<img src="./logo-en.svg" alt="header logo">
|
||
</a>
|
||
<!-- <div class="hero__search-form" id="search-panel">
|
||
<form class="search-form" onsubmit="ym(83180416,'reachGoal','poisk')">
|
||
<label class="search-form__label">
|
||
<span id="reset-search" class="search__icon"></span>
|
||
<input class="search-form__input" type="text">
|
||
</label>
|
||
<input class="search-form__submit" type="submit" value="Submit">
|
||
</form>
|
||
</div> -->
|
||
|
||
<div class="hero__search-form" id="search-panel"> <form class="search-form"> <label class="search-form__label"> <span id="reset-search" class="search__icon"></span> <input class="search-form__input" type="text"> </label> <input class="search-form__submit" type="submit" value="Submit"> </form> </div>
|
||
<div class="hero__search">
|
||
<a href="#" id="search-icon" class="hero__search-icon">
|
||
<img src="search-icon-white.svg" alt="search string">
|
||
</a>
|
||
<a href="#" id="side-menu-icon" class="hero__side-icon">
|
||
<img src="side_menu.svg" alt="side menu">
|
||
</a>
|
||
</div>
|
||
<div class="header__navi">
|
||
|
||
<ul class="header__list"><li><span class="solution-select"><span class="solution-select__selected"></span><svg width="7" height="4" viewBox="0 0 7 4" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M1 1L3.5 3.5L6 1" stroke="white" stroke-linecap="round" stroke-linejoin="round"/></svg><ul class="solution-select__list"><li><a class="project-link" href="https://brix365.com/en/help/platform/get-trial.html">Platform</a></li><li><a class="project-link" href="https://brix365.com/en/help/ecm/ecm-functions.html">ECM</a></li><li><a class="project-link" href="https://brix365.com/en/help/crm/crm_overview.html">CRM</a></li><li><a class="project-link" href="https://brix365.com/en/help/service/service-functions.html">Service</a></li><li><a class="project-link" href="https://brix365.com/en/help/projects/projects-functions.html">Projects</a></li><li><a class="project-link" href="https://brix365.com/en/help/business_solutions/-elma365-store.html">Business Solutions</a></li></ul></span></li><li><a href="https://api.brix365.com/en/" target="_blank">API</a></li><li><a href="https://tssdk.brix365.com/" target="_blank">SDK</a></li></ul>
|
||
|
||
|
||
</div>
|
||
</div>
|
||
|
||
</header>
|
||
|
||
|
||
|
||
|
||
<main class="main container">
|
||
|
||
<aside class="sidebar" id="sidebar">
|
||
<div class="sidebar__header">
|
||
<a class="header__logo" href="https://brix365.com/en/help">
|
||
<img src="./logo-light-en.svg">
|
||
</a>
|
||
<span class="sidebar__close elma-365-close" id="close"></span>
|
||
</div>
|
||
<div class="sidebar__wrapper" id="side-menu">
|
||
|
||
</div>
|
||
</aside>
|
||
|
||
<article class="article" id="article">
|
||
<div class="article-inner">
|
||
<div class="content">
|
||
<header class="article__header">
|
||
<div class="article__bread" style="display:flex; gap:10px;">
|
||
<span id="subcategory" class="search-res__item-category search-res__item-category_subcategory subcategory article__badge"></span>
|
||
|
||
<div class="topic__breadcrumbs">
|
||
<p>Low-code designer > <a href="interface_settings.html">Set up interfaces</a> > Widget types / Custom widgets</p>
|
||
</div>
|
||
|
||
</div>
|
||
<div class="topic__title"><h1 class="p_Heading1"><span class="f_Heading1">Custom widgets</span></h1>
|
||
</div>
|
||
|
||
</header>
|
||
<section class="article__content">
|
||
<div class="scroll-top-inner">
|
||
<a href="#h1-article" class="scroll-top"></a>
|
||
</div>
|
||
<!-- Placeholder for topic body. -->
|
||
<p style="line-height: 1.20; background: #ffffff; margin: 7px 0 16px 0;"><span style="font-family: Inter; color: #394149;">Users who are members of the <a href="360006871932.html" class="topiclink">Administrators</a> group can create and publish such widgets. By creating a custom widget, you can:</span></p>
|
||
<ul style="list-style-type:disc">
|
||
<li class="p_Normal">On a custom widget, place other system and custom widgets, as well as<a href="context_types.html" class="topiclink"> context variables</a> and <a href="client_server_scripts.html" class="topiclink">scripts</a>.</li><li class="p_Normal">Enable <a href="user-widgets-context.html" class="topiclink">additional options</a> that control the display and value of context variables when the widget is added to a form or page.</li><li class="p_Normal">Create a unique widget <a href="user-widgets-context.html#window" class="topiclink">setting window</a>.</li><li class="p_Normal">Set <a href="common_widget_settings.html" class="topiclink">system settings</a> that will be applied by default when the widget is placed on any interface element (page, form, other widget)<span style="font-family: Inter; color: #394149;">.</span></li><li class="p_Normal"><span style="font-family: Inter; color: #394149;"><a href="designer-tabs.html#settings" class="topiclink">Set up the location and design on the widget</a> on a form and in the interface designer.</span></li></ul>
|
||
<p style="line-height: 1.20; background: #ffffff; margin: 7px 0 16px 0;"><span style="font-family: Inter; color: #394149;">To finish configuring the widget, in the top panel of the interface designer, click </span><span style="font-family: Inter; font-weight: bold; color: #394149;">Save</span><span style="font-family: Inter; color: #394149;"> and </span><span style="font-family: Inter; font-weight: bold; color: #394149;">Publish</span><span style="font-family: Inter; color: #394149;">. The widget will then appear in the </span><span style="font-family: Inter; font-weight: bold; color: #394149;">Custom widgets</span><span style="font-family: Inter; color: #394149;"> group and you can use it multiple times.</span></p>
|
||
<p style="line-height: 1.20; background: #ffffff; margin: 7px 0 16px 0;"><span style="font-size: 13px; color: #000000; background-color: #ffffff;"> </span></p>
|
||
<p style="line-height: 1.28; margin: 0 0 11px 0;"><img alt="CustomW1" width="266" height="260" style="margin:0;width:266px;height:260px;border:none" src="customw1.png"/></p>
|
||
<p style="line-height: 1.20; background: #ffffff; margin: 7px 0 16px 0;"><span style="font-family: Inter; color: #394149;">To learn more about the system interface, see </span><span style="font-family: Inter;"><a href="interface_settings.html" class="topiclink">Set up interfaces</a></span><span style="font-family: Inter; color: #394149;"> and </span><span style="font-family: Inter;"><a href="interface_designer.html" class="topiclink">Interface designer</a></span><span style="font-family: Inter; color: #394149;">.</span></p>
|
||
<h2 class="p_Heading2"><span class="f_Heading2">Custom widget builder</span></h2>
|
||
<p class="p_Normal">Let’s see how a custom widget is configured. Consider that the <span style="font-weight: bold;">Analytics</span> custom widget is placed on the report form. Now we will move on to its settings:</p>
|
||
<ol style="list-style-type:decimal">
|
||
<li value="1" class="p_Normal">Open the report form template in interface designer, select the widget, and click the gear icon.<br />
|
||
<img alt="custom_widgets_01" width="1309" height="560" style="margin:0;width:1309px;height:560px;border:none" src="custom_widgets_01.png"/></li></ol>
|
||
<p class="p_Normal"> Options are available in the opened menu:</p>
|
||
<ul style="list-style-type:disc">
|
||
<li class="p_Normal"><span style="font-weight: bold;">Customize</span>. Open widget settings that will be applied only on the current form.</li><li class="p_Normal"><span style="font-weight: bold;">Go to Builder</span>. Open the widget template to specify system settings that will be applied by default on any interface element where the widget is used.</li></ul>
|
||
<ol style="list-style-type:decimal" start="2">
|
||
<li value="2" class="p_Normal">Select the <span style="font-weight: bold;">Go to Builder</span> option. This opens the widget template in the interface designer. Select the widget and click the gear icon.<br />
|
||
<img alt="custom_widgets_02" width="950" height="458" style="margin:0;width:950px;height:458px;border:none" src="custom_widgets_02.png"/></li><li value="3" class="p_Normal">In the settings window that opens, on the <span style="font-weight: bold;">System</span> tab, in the <span style="font-weight: bold;">HTML styles</span> field, set the value width: <span style="font-weight: bold;">100%</span>.<br />
|
||
<img alt="custom_widgets_03" width="998" height="495" style="margin:0;width:998px;height:495px;border:none" src="custom_widgets_03.png"/><br />
|
||
Then on any form or page, the widget will be displayed by default to the full width of the element within which it is located. In our example, the <span style="font-weight: bold;">Analytics</span> widget will be displayed to the full width of the report.<br />
|
||
<img alt="custom_widgets_04" width="965" height="424" style="margin:0;width:965px;height:424px;border:none" src="custom_widgets_04.png"/></li><li value="4" class="p_Normal">Open the report form template again, select the <span style="font-weight: bold;">Analytics</span> widget, click the gear icon, and select the <span style="font-weight: bold;">Configure</span> option.</li><li value="5" class="p_Normal">The settings that apply only to the current form will be displayed. If you set <span style="font-weight: bold;">width: 50%</span> in the <span style="font-weight: bold;">HTML styles</span> field, it will be applied to the current report form instead of the <span style="font-weight: bold;">width: 100%</span> value set<span style="font-family: Inter; color: #394149;"> earlier.</span><br />
|
||
<img alt="custom_widgets_05" width="1002" height="372" style="margin:0;width:1002px;height:372px;border:none" src="custom_widgets_05.png"/></li></ol>
|
||
<p style="line-height: 1.20; background: #ffffff; margin: 7px 0 16px 0;"><span style="font-size: 13px; color: #000000; background-color: #ffffff;"> </span></p>
|
||
<h2 class="p_Heading2"><a id="page" class="hmanchor"></a><span class="f_Heading2">Page widget</span></h2>
|
||
<p style="line-height: 1.20;"><span style="font-size: 15px; color: #394149;">To configure <a href="360009924451.html" class="topiclink">pages</a>, which are also a part of the system structure like an app or workspace, you can use widgets of the </span><span style="font-size: 15px; font-weight: bold; color: #394149;">Page</span><span style="font-size: 15px; color: #394149;"> type. </span></p>
|
||
<p style="line-height: 1.20; margin: 16px 0 0 0;"><span style="font-size: 15px; color: #394149;">When you are</span><span style="font-size: 15px; color: #394149;"> </span><span style="font-size: 15px; color: #394149;"><a href="360027211631.html" class="topiclink">setting up</a></span><span style="font-size: 15px; color: #394149;"> </span><span style="font-size: 15px; color: #394149;">a page in the interface designer, you are actually working in a widget template of the </span><span style="font-size: 15px; font-weight: bold; color: #394149;">Page</span><span style="font-size: 15px; color: #394149;"> type. By filling it up with other widgets, context variables, and scripts, you are creating a custom </span><span style="font-size: 15px; font-weight: bold; color: #394149;">Page</span><span style="font-size: 15px; color: #394149;"> widget.</span></p>
|
||
<p style="line-height: 1.20; margin: 16px 0 0 0;"><span style="font-size: 15px; color: #394149;">You can also create such a widget in</span><span style="font-size: 15px; color: #394149;"> </span><span style="font-weight: bold; color: #394149;">Administration > Interfaces</span><span style="font-size: 15px; color: #394149;">. In the top-right corner, click</span><span style="font-size: 15px; color: #394149;"> </span><span style="font-weight: bold; color: #394149;">+Create</span><span style="font-size: 15px; color: #394149;"> and select </span><span style="font-size: 15px; font-weight: bold; color: #394149;">Page</span><span style="font-size: 15px; color: #394149;">. To learn more, see</span><span style="font-size: 15px; color: #394149;"> </span><span style="font-size: 15px; color: #394149;"><a href="interface_settings.html#widgets" class="topiclink">Set up interfaces</a></span><span style="font-size: 15px; color: #394149;">.</span></p>
|
||
<p style="line-height: 1.20; margin: 16px 0 16px 0;"><span style="font-size: 15px; color: #394149;">When a </span><span style="font-size: 15px; font-weight: bold; color: #394149;">Page</span><span style="font-size: 15px; color: #394149;"> widget is ready, you can reuse it on different pages. To add it to a new page, click </span><span style="font-size: 15px; font-weight: bold; color: #394149;">Add widget</span><span style="font-size: 15px; color: #394149;"> when creating the page. Then select the widget from the list of custom widgets.</span></p>
|
||
<p style="line-height: 1.20; margin: 16px 0 16px 0;"><img alt="custom_widgets_06" width="675" height="320" style="margin:0;width:675px;height:320px;border:none" src="custom_widgets_06.png"/></p>
|
||
|
||
<div class="bottom-nav">
|
||
|
||
<a id="prev-link" class="topic__navi_prev" href="360028902011.html">
|
||
<span class="bottom-nav__arrow bottom-nav__arrow--prev"></span> <span
|
||
class="bottom-nav__link">360028902011.html</span>
|
||
</a>
|
||
|
||
|
||
<a id="next-link" class="topic__navi_next" href="360008121732.html">
|
||
<span class="bottom-nav__link">360008121732.html</span> <span
|
||
class="bottom-nav__arrow bottom-nav__arrow--next"></span>
|
||
</a>
|
||
|
||
</div>
|
||
<!-- добавляет на страницу строку блок Была ли статья полезной? -->
|
||
<div class="feedback" id="feedback"><div class="feedback-help"><span><b>Was this helpful?</b></span><form action="" method="POST" class="feedback-form" id="feedback-form"><div class="feedback__popup feedback__popup-response" id="feedback__popup_thx" style="display: none;">Thanks for your feedback!</div><div class="feedback__popup" id="feedback__popup_why" style="display: none;"><div class="feedback__popup-header">Please specify why:</div><input type="radio" name="category" id="bad_recommendation" value="bad_recommendation"><label for="bad_recommendation">Recommendations did not help me</label><input type="radio" name="category" id="difficult_text" value="difficult_text"><label for="difficult_text">Article is hard to understand</label><input type="radio" name="category" id="no_answer" value="no_answer"><label for="no_answer">Didn`t answer my question</label><input type="radio" name="category" id="bad_header" value="bad_header"><label for="bad_header">Content does not match the topic</label><input type="radio" name="category" id="other_reason" value="other_reason"><label for="other_reason">Other</label></div><div class="feedback__popup" id="feedback__popup-other" style="display: none;"><div class="feedback__popup-header">How we can improve it?</div><textarea class="feedback__textarea" name="other" id=""></textarea><input type="submit" class="feedback__other-btn" value="Submit"></div><div class="feedback-form__btn-group"><input type="radio" name="useful" id="feedback__useful_yes" value="true"><label for="feedback__useful_yes"><img src="like.svg" class="small-img" alt="like"><spanclass="feedback-form__btn-group_yes-btn">Yes</spanclass="feedback-form__btn-group_yes-btn"></label><input type="radio" name="useful" id="feedback__useful_no" value="false"><label for="feedback__useful_no"><img src="dislike.svg" class="small-img" alt="dislike"><spanclass="feedback-form__btn-group_no-btn">No</spanclass="feedback-form__btn-group_no-btn"></label></div><select name="category"><option disabled="">Please specify why</option><option value="bad_recommendation" selected="">Recommendations did not help me</option><option value="difficult_text">Article is hard to understand</option><option value="no_answer">Didn`t answer my question</option><option value="bad_header">Content does not match the topic</option><option value="other_reason">Other</option></select><input type="submit"></form></div><div class="found_typo"><p style="margin: 0px; margin-top: 16px !important;"><span><b>Found a typo?</b></span> Select it and press <i>Ctrl+Enter</i> to send us feedback</p></div></div>
|
||
|
||
</section>
|
||
</div>
|
||
<aside class="article__sidebar" style="display:none">
|
||
<input type="checkbox" />
|
||
<div class="article__arrow"></div>
|
||
<div class="table-of-contents elma365-right" id="toc2Content">
|
||
<h3 class="h3-toc">In this topic</h3>
|
||
<nav id="toc2"></nav>
|
||
</div>
|
||
</aside>
|
||
</div>
|
||
</article>
|
||
</main>
|
||
<footer class="footer">
|
||
<div class="footer-container">
|
||
<div class="footer-mobile">
|
||
|
||
<ul class="footer-mobile__list"><li><a href="https://brix365.com/en/" target="_blank">BRIX</a></li><li><a href="https://tssdk.brix365.com/en/latest/" target="_blank">SDK</a></li><li><a href="https://api.brix365.com/en/" target="_blank">API</a></li></ul><ul class="footer-mobile__list"><li><a href="https://brix365.com/en/help/platform/get-trial.html">Platform</a></li><li><a href="https://brix365.com/en/help/ecm/ecm-functions.html">ECM</a></li><li><a href="https://brix365.com/en/help/service/service-functions.html">Service</a></li><li><a href="https://brix365.com/en/help/projects/projects-functions.html">Projects</a></li></ul>
|
||
|
||
|
||
</div>
|
||
<div class="footer-wrap">
|
||
|
||
<div><span class="mobile-question-popup">Send feedback</span><form method="POST" action class="question__popup question-xs" id="question__popup"><div class="question-wrap"><span class="close"></span><span class="title">Ask a question</span><label for="help_question" style="display: none;"></label><textarea name="help_question" id="help_question"></textarea><input type="submit" value="Send"></div></form><div class="hidden fade-in question-success-xs">Sent</div></div>
|
||
|
||
<div class="footer-flex-b">
|
||
<span class="footer-copy">© 2025 BRIX</span>
|
||
<ul class="footer-list">
|
||
|
||
<li class="footer-item">
|
||
<a href="#" class="arrow-top" style="display: block;"></a>
|
||
</li>
|
||
|
||
</ul>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
|
||
</footer>
|
||
<iframe name="hmnavigation" style="display:none!important"></iframe>
|
||
<script src="./jquery-ui.js"></script>
|
||
<!--script src="//cdn.jsdelivr.net/npm/featherlight@1.7.14/release/featherlight.min.js" type="text/javascript" charset="utf-8"></script-->
|
||
<script src="./jquery.tocify.min.js"></script>
|
||
<script src="./TypoReporter.min.js"></script>
|
||
<script src="./google-search.js"></script>
|
||
<script src="./main.js"></script>
|
||
</body>
|
||
|
||
</html>
|