Working with pages

Смотреть видео

Managing pages

Pages are created in the admin panel under Pages .

Only the roles specified in the field can access the page Roles(separated by commas without spaces. If all is specified, then everyone has access. If * - only authorized users). 

Security and access control in Falcon Space



Each page can have its own JS and CSS files. You can change them via the page management page. 

All functionality is added via special markup snippets , such as as crud, as form, as editable, and so on.

An example of a snippet:

<div class="as-form" data-code="form1" data-itemid="12"></div>

- when output is converted to the output of a form with the code code1

page Address - /{code}, where code is the page code. 

Parameters in the markup are used for linking pages , which are replaced with URL parameters when rendering the page (in most cases, it is better to use the itemID parameter to identify additional objects, since it is implicitly passed to the page, for example,/page1/code1 means going to the page page1 and itemID=Code1). 

You can also pass the parameter in the markup to output the current user's name. 



Note: 

  • The cabinet Menu is determined based on the menu section, as well as from those pages that have the show in the menu check box. 
  • Important! Don't change the page code unnecessarily (JS and CSS files are created based on the page code + the page URL will change if you change the code) + stored procedures with breadcrumbs are tied to this field.
  • The page will only be viewable for the role it was created for.
  • Snippets-set the typical markup, so that it is not typed from memory. Try to specify all the parameters that the snippet gives (i.e. if you don't need a parameter, leave it empty or 0).
  • For control panel pages, specify the control Panel and icon check box in the settings.This page will be considered the main page for your account and can be used for redirects to log in to your account.  
  • All page visits are saved in as_trace with the pv code (url, falconGuid, and in some cases itemID are saved).
  • You can use a special mode for pages where you can output markup with logic via JSRender. To do this, check the JS Render Mode and use special markup (but keep in mind that the data output on the page will not be indexed by search engines).

     

          JS Render passes an object with the fields username( the name of the current user), roles (an array of roles), urlParameters (URL parameters as an object {key:value, ...}).

  • To edit the page, click the edit icon at the top right.  

       

  • You can specify which Layout to use for the page (page Editing/Right column) - either Cabinet (for user Cabinet pages), or front (for pages with unauthorized access, such as Catalog, Trash, etc.).  
  • The main page uses a page with a special code _default. In this case, the web. config parameter in App Settings must be specified hasDefaultPage= ” 1 ”  
  • You can't use page codes that start with these words:  controls, arkstuff, admin, catalog, account, api, list, home.
  • The page name is included in the page title, as well as in the menu formation (if there is a check mark in the Menu). 

SQL page management procedure

For a page, you can use SQL (button SQL Pages) to implement various business logic on SQL. 

Input parameters

  1. @roles - comma-separated roles of the current user. 
  2. @itemID - passed the itemID parameter in the URL
  3. @urlParameters - a collection of parameters from the URL (Key, Value). It also passes special parameters that are added by the system (i.e. they are not accepted from the browser): 
    1. langID - current language
    2. username - current user

Output parameters.

    1. SELECT 1-Bread crumbs
    2. SELECT 2 -
      1. Title, Description, Keywords - SEO parameters of the page, the title tag and the Description and Keywords meta tags. 
      2. RedirectUrl - if set, redirects to another page.
      3. BodyBottomSection - here you can insert additional scripts (or dynamic markup)
      4. HeadSection here you can insert connections for additional styles
      5. IntroRunBtnText, 1 IntroInstantRun - set parameters of the page description wizard. IntroRunBtnText-text of the wizard start button (by default, it becomes on the right side of the page). IntroInstantRun - if 1, the wizard starts immediately when the page loads (it is shown automatically only 1 time when loading).
    3. SELECT 3 - Additional parameters in a separate query that can be output on the page via {sp - par1}, where par1 is the name of the parameter in SQL. It also passes markup for list data (list1Makeup, list2Makeup… list5Makeup). 
    4. SELECT 4-8-list data in p1... p6 format, they are used in markuplistXMakeup
    5. SELECT 9-tinctures of the page familiarization wizard. 
      1. Selector-selector of the element on the page (. btn)
      2. Event - which event will move to the next element (next - by clicking the Forward button, click - by clicking on the Selector element)
      3. Description-description text
      4. Shape - which shape is selected for the element (rect, circle)
      5. ScrollAnimationSpeed   animation speed in MS (300)
      6. Raduis-radius of the selected area at   Shape = circle (100)
      7. Margin-margins of the selected area (50)
      8. NextText - text of the Next button. If omitted, the button is hidden.
      9. SkipText - text of the Close button. If omitted, the button is hidden.
    6. SELECT 10-suggestions for elements (when hovering or clicking)
      1. Selector - selector of the element to output the hint for. 
      2. Event - click or mouseenter (when hovering)
      3. Text - output text
      4. Type - color scheme for the output window (danger, info, etc.)
      5. ShowType - toast (output of a hint from the top to the top) or tooltip (a minimap that will be output when hovering).
        CREATE PROCEDURE [dbo].[pg_crumbs_supplierProjects]
        	@roles nvarchar(128),
        	@itemID nvarchar(128) = '',
                @urlParameters CRUDFilterParameter READONLY
        AS
        BEGIN
        	CREATE TABLE dbo.#result (title nvarchar(256), link nvarchar(256), tooltip
                                          nvarchar(256), ord int)
        
        
        	insert into #result
        	select 'Home', '/', '', 1
        	union
        	select 'Desktop', '/home/p/supplierCabinet', '', 2
        	union
        	select 'My projects', '', '', 3
        
                -- the first request - breadcrumb
        	select * from #result order by ord
        
                -- the second request - seo parameters и RedirectUrl
                select 'My projects' Title, '' RedirectUrl
        
                -- the third request in free format, additional parameters
                select 'Par1' as Par1
        	drop table #result
        END

The special page

  • _default - The main page of the site
  • notfound - page for displaying 404 errors (situations when the requested page is not found)
  • noaccess - the page is displayed when the user does not have access to the requested page. 
Falcon Space is a functional web development platform on a narrow stack MS SQL/Bootstrap. Falcon Space Gettting started
Note