Technical Customisation
Last updated
Last updated
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
Repo:
Use the dev branch as the base branch for development.
Clone the repo and start using the following steps:
## install
yarn install
## start dev server
yarn start
Modules are enabled by the MDMS config at.
To add and enable any module in the new UI, src/App.js needs to be changed.
Till PGR, we used to export the Module and Links were added to the registry. Now, adding to the registry is part of the modules themselves. We export only the init function of the module to take care of all the initialisations. Going forward, these init functions will have to be called. We will create the init function of PGR as well. These init modules must be called after initLibraries.
CSS classes are published over CDN and can be seen at: https://unpkg.com/@egovernments/digit-ui-css/dist/index.css
Any class can be overwritten. Make changes in the src/index.css file.
Add any new component created in the registry,
Digit.ComponentRegistryService.setupRegistry({
SelectName: SelectName
});
If API calls are failing, the do the following:
Check src/setupProxy.js for proxy url in dev mode.
If API calls are failing with no authorisation token, then do the following:
Create a .env file with following:
REACT_APP_USER_TYPE=
REACT_APP_CITIZEN_TOKEN=a3e5f0a2-4ff0-4680-855e-75051fb3e8f7
REACT_APP_EMPLOYEE_TOKEN=061bad07-c0d5-4200-a74f-ca5ed090cf30
REACT_APP_GRO_TOKEN=43af4c18-6418-4a35-8484-31f0700f465a
REACT_APP_LME_TOKEN=fa9f4184-dc64-495d-bded-31674c71b09e
It is done on dev via:
Create a new branch for the state if already doesn’t exist from the master of repo:
To add and enable any module in the new UI, src/App.js needs to be changed.
We only export the init function of the module to take care of all the initialisations:
import { initFSMComponents } from "@egovernments/digit-ui-module-fsm";
const enabledModules = ["FSM"];
initFSMComponents();
CSS classes are published over CDN and can be seen at: https://unpkg.com/@egovernments/digit-ui-css/dist/index.css
Any class can be overwritten. Make changes in the src/index.css file.
Add any new component created in the registry,
Digit.ComponentRegistryService.setupRegistry({
SelectName: SelectName});
The config has different items in the application form. The new config, if made, needs to be initialised at Digit.Customizations.FSM.applicationFormConfig
label: is the employee side label
texts: is used for citizen side step form
- t: translate function to be used to convert a key to localized text. e.g., t("CS_CREATECOMPLAINT_MOHALLA")
- config: current step config as shown above
- onSelect: on clicking of next or input, this handled to be called to save the data in the form state
- userType: employee or citizen
- formData: the current form state
Application details can be customised via defining: Digit.Customizations.FSM.getApplicationDetailsTableRows
The function will be passed following params:
id: application id
service: application response object
role: currently logged in user role CITIZEN or EMPLOYEE
t: function used for translation
Following customisations are available:
userRole : Role of the logged in user for application of customisation.
statuses : List of statuses that needs to be shown for the specified user.
zeroCheck : Check if the total application count for any status is 0 to hide or rearrange the list.
fixed : Limits the status filter list to the specified list.
Modules are enabled by the MDMS config at: .
.
Application config: The default config can be found at.
component: the component that is to be rendered here. Any component can be created to show here; examples can be seen at, These components are passed following params:
Similarly, in case of Applicant Details, MDMS config is located at:
The Trip Details MDMS config is located at:
Status can be filtered and rendered by MDMS config located at: