' + message + '

' }], primary_action_label: 'Yes', primary_action: function () { decided = true; d.hide(); if (on_yes) on_yes(); }, secondary_action_label: 'No', secondary_action: function () { decided = true; d.hide(); if (on_no) on_no(); } }); d.onhide = function () { if (!decided && on_no) on_no(); }; d.show(); } /* Three-choice dialog: Delete Existing / Continue With Existing / No. Closing with the X counts as "No". */ function ask_three_way(title, message, on_delete, on_continue, on_no) { let decided = false; let d = new frappe.ui.Dialog({ title: title, fields: [{ fieldtype: 'HTML', fieldname: 'content', options: '

' + message + '

' }] }); /* Not using Frappe's footer at all */ d.$wrapper.find('.modal-footer').hide(); let $buttons = $('

').css({ 'display': 'flex', 'justify-content': 'flex-end', 'align-items': 'center', 'gap': '8px', 'flex-wrap': 'wrap', 'margin-top': '16px' }); function make_btn(label, css_class, handler) { let $btn = $('').text(label); $btn.on('click', function () { decided = true; d.hide(); if (handler) handler(); }); return $btn; } $buttons.append( make_btn('No', 'btn-default', on_no), make_btn('Delete Existing', 'btn-default', on_delete), make_btn('Continue With Existing', 'btn-primary', on_continue) ); d.$body.append($buttons); d.onhide = function () { if (!decided && on_no) on_no(); }; d.show(); } /* ========================================================= STANDARDIZED TEXTS (shared by Applied and Still Busy) ========================================================= */ /* Standard "email can't be used" message, then clear the field */ function reject_email() { clear_email_field(); frappe.msgprint({ title: 'Email Already In Use', message: TXT_EMAIL_IN_USE, indicator: 'red' }); } /* ========================================================= VERIFICATION (identity details -> emailed code -> action) ========================================================= */ /* Hide any leftover fieldname text shown under the inputs in a dialog */ function hide_dialog_fieldnames(d) { function run() { d.$wrapper.find('.frappe-control').each(function () { let $control = $(this); let fieldname = $control.attr('data-fieldname'); if (!fieldname) return; $control.find('*').filter(function () { let $el = $(this); return !$el.is('label, .control-label, input, select, textarea') && $el.children().length === 0 && $el.text().trim() === fieldname; }).hide(); }); } run(); setTimeout(run, 100); /* once more after Frappe finishes rendering */ } /* Red message under a dialog field. Pass '' to clear. */ function show_field_error(d, fieldname, text) { let f = d.get_field(fieldname); if (!f) return; f.$wrapper.find('.field-error').remove(); if (!text) return; $('

') .css({ 'color': '#e24c4c', 'font-size': '12px', 'margin-top': '4px' }) .text(text) .appendTo(f.$wrapper); } /* Red message above the buttons for errors that belong to no single field */ function show_general_error(d, text) { let f = d.get_field('general_error'); if (!f) return; f.$wrapper.html(text ? '

' + esc(text) + '

' : ''); } /* Clear a field's error as soon as the user edits it */ function clear_error_on_edit(d, fieldnames) { fieldnames.forEach(function (fn) { let f = d.get_field(fn); if (!f) return; f.$wrapper.find('input').on('input', function () { show_field_error(d, fn, ''); show_general_error(d, ''); }); }); } /* Step 3: enter the emailed code */ function ask_code(email, action) { let done = false; let d = new frappe.ui.Dialog({ title: 'Enter Your Code', fields: [ { fieldtype: 'HTML', options: '

We have emailed a 4-digit code to ' + esc(email) + '. ' + 'It is valid for 10 minutes. Please also check your Junk/Spam folder.

' }, { fieldtype: 'Data', fieldname: 'code', label: 'Code', reqd: 1 }, { fieldtype: 'HTML', fieldname: 'general_error' } ], primary_action_label: 'Verify', primary_action: function (values) { d.get_primary_btn().prop('disabled', true); frappe.call({ method: 'application_portal.api.verify_web_form_code', args: { email_address: email, code: values.code, action: action }, callback: function (r) { let res = r.message || {}; if (res.ok) { done = true; d.hide(); if (action === 'delete') { frappe.show_alert({ message: 'Your previous application was deleted. You can now continue with a new one.', indicator: 'green' }, 7); } else { clear_email_field(); frappe.msgprint({ title: 'Check Your Email', message: 'We have sent an email to ' + esc(email) + ' with a link to the ' + 'Application Portal so you can continue with your existing application. ' + 'Please check your Junk/Spam folder just in case.', indicator: 'green' }); } return; } d.get_primary_btn().prop('disabled', false); show_field_error(d, 'code', res.message || 'Verification failed.'); if (res.expired) { done = true; d.hide(); reject_email(); } }, error: function () { d.get_primary_btn().prop('disabled', false); how_general_error(d, 'Too many requests. Please wait a while and try again.'); } }); } }); d.onhide = function () { if (!done) reject_email(); }; d.show(); hide_dialog_fieldnames(d); clear_error_on_edit(d, ['code']); } /* Step 2: identity details */ function start_verification(email, info, action) { let done = false; let intro = (action === 'delete') ? 'To delete your existing application, please confirm your identity. ' + 'This cannot be undone.' : 'To continue with your existing application, please confirm your identity.'; let d = new frappe.ui.Dialog({ title: 'Verify Your Identity', fields: [ { fieldtype: 'HTML', options: '

' + intro + ' Enter the details you used on your original application. ' + 'We will then email you a 4-digit code.

' }, { fieldtype: 'Data', fieldname: 'identity_number', label: info.identity_label || 'Identity Number', reqd: 1 }, { fieldtype: 'Data', fieldname: 'email_address', label: 'Email Address', default: email, read_only: 1 }, { fieldtype: 'Data', fieldname: 'contact_number', label: 'Contact Number', reqd: 1 }, { fieldtype: 'HTML', fieldname: 'general_error' } ], primary_action_label: 'Send Code', primary_action: function (values) { show_general_error(d, ''); ['identity_number', 'email_address', 'contact_number'].forEach(function (fn) { show_field_error(d, fn, ''); }); d.get_primary_btn().prop('disabled', true); frappe.call({ method: 'application_portal.api.request_web_form_code', args: { email_address: email, identity_number: values.identity_number, contact_number: values.contact_number, action: action }, callback: function (r) { let res = r.message || {}; if (res.ok) { done = true; d.hide(); setTimeout(function () { ask_code(email, action); }, 300); return; } d.get_primary_btn().prop('disabled', false); show_field_error(d, 'identity_number', (res.errors || {}).identity_number); show_field_error(d, 'email_address', (res.errors || {}).email_address); show_field_error(d, 'contact_number', (res.errors || {}).contact_number); if (!res.errors) { show_general_error(d, res.message || 'Verification failed.'); } }, error: function () { d.get_primary_btn().prop('disabled', false); how_general_error(d, 'Too many requests. Please wait a while and try again.'); } }); } }); d.onhide = function () { if (!done) reject_email(); }; d.show(); hide_dialog_fieldnames(d); clear_error_on_edit(d, ['identity_number', 'contact_number']); } /* Single popup for Applied and Applicant Still Busy */ function ask_existing_choice(email, info, intro, opts) { ask_three_way( 'Existing Application Found', intro + '

' + application_details_html(info, opts) + '
' + 'What would you like to do?

' + '

Continue With Existing: we will email you a link to the Application Portal ' + 'to continue with your existing application.
Delete Existing: your existing application will be deleted and you can ' + 'start a new one.
No: this email address cannot be used on this form.

' + 'For your security, we will ask you to verify your identity before continuing.', function () { setTimeout(function () { start_verification(email, info, 'delete'); }, 300); }, function () { setTimeout(function () { start_verification(email, info, 'continue'); }, 300); }, function () { reject_email(); } ); } /* ========================================================= MAIN HANDLER ========================================================= */ function handle_existing_application(email, info) { /* ---------- SUBMITTED ---------- */ if (info.status === 'Submitted') { clear_email_field(); frappe.msgprint({ title: 'Application Already Submitted', message: 'An application has already been submitted using this email address, ' + 'so it cannot be used again.

' + application_details_html(info, { include_submitted: true }), indicator: 'red' }); return; } /* ---------- APPLIED ---------- */ if (info.status === 'Applied') { ask_existing_choice( email, info, 'A record already exists with this email address and is still in the Applied state.' ); return; } /* ---------- APPLICANT STILL BUSY ---------- */ if (info.status === 'Applicant Still Busy') { ask_existing_choice( email, info, 'A record already exists with this email address, and you have already accessed it via the Application Portal.', { include_last_saved: true } ); } } function run_existing_application_check() { /* Don't run when editing an already-saved record */ if (frappe.web_form.doc && frappe.web_form.doc.name) return; let email = (frappe.web_form.get_value('email_address') || '').trim(); if (!email || email === last_checked_email) return; /* Only check once it looks like a real email */ if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) return; last_checked_email = email; frappe.call({ method: 'application_portal.api.check_existing_application', args: { email_address: email }, callback: function (r) { if (r.message) handle_existing_application(email, r.message); } }); } function setup_existing_application_check() { let field = frappe.web_form.get_field('email_address'); if (!field) return; field.$wrapper.find('input').on('change blur', function () { /* Small delay so the email format validator runs first */ setTimeout(run_existing_application_check, 50); }); } setup_existing_application_check(); /* ========================================================= YEAR OPTIONS ========================================================= */ /* ========================================================= DEPENDENT FIELDS ========================================================= */ function toggle_dependent_field( fieldname, condition ) { let field = frappe.web_form.get_field( fieldname ); if (!field) { return; } frappe.web_form.set_df_property( fieldname, 'reqd', condition ? 1 : 0 ); frappe.web_form.set_df_property( fieldname, 'hidden', condition ? 0 : 1 ); if (condition) { field.$wrapper.show(); } else { field.$wrapper.hide(); } } /* ========================================================= CITIZENSHIP DEPENDENT FIELDS ========================================================= */ function refresh_citizenship_dependent_fields() { let citizen_yes = frappe.web_form.get_value( 'citizen_yes' ); let citizen_no = frappe.web_form.get_value( 'citizen_no' ); toggle_dependent_field( 'national_id_number', citizen_yes ); toggle_dependent_field( 'identity_document_type', citizen_no ); toggle_dependent_field( 'identity_document_no', citizen_no ); } /* ========================================================= READ ONLY FIELDS ========================================================= */ function set_field_read_only( fieldname, condition ) { let field = frappe.web_form.get_field( fieldname ); if (!field) { return; } frappe.web_form.set_df_property( fieldname, 'read_only', condition ? 1 : 0 ); if (field.refresh) { field.refresh(); } } /* ========================================================= COUNTRY / PROVINCE ========================================================= */ function apply_postal_province_restriction() { let country_value = frappe.web_form.get_value( 'country' ); let is_not_sa = country_value && country_value !== 'South Africa'; if (is_not_sa) { frappe.web_form.set_value( 'province', 'Other' ); } set_field_read_only( 'province', is_not_sa ); } /* ========================================================= CITIZEN DEPENDENT LOCKS ========================================================= */ function apply_citizen_dependent_locks() { let citizen_yes = frappe.web_form.get_value( 'citizen_yes' ); if (citizen_yes) { frappe.web_form.set_value( 'nationality', 'South African' ); } set_field_read_only( 'nationality', citizen_yes ); if (citizen_yes) { frappe.web_form.set_value( 'country', 'South Africa' ); } set_field_read_only( 'country', citizen_yes ); apply_postal_province_restriction(); apply_attachment_restrictions(); } /* ========================================================= COUNTRY HANDLER ========================================================= */ function setup_postal_country_restriction() { let country_field = frappe.web_form.get_field( 'country' ); if (!country_field) { return; } let $country_input = country_field.$wrapper.find( 'input' ); $country_input.on( 'blur awesomplete-selectcomplete change', function() { apply_postal_province_restriction(); } ); apply_postal_province_restriction(); } setup_postal_country_restriction(); /* ========================================================= CITIZENSHIP CHECKBOXES ========================================================= */ function setup_citizenship_checkboxes() { let yes_field = frappe.web_form.get_field( 'citizen_yes' ); let no_field = frappe.web_form.get_field( 'citizen_no' ); if (!yes_field || !no_field) { return; } let $yes_input = yes_field.$wrapper.find( 'input[type="checkbox"]' ); let $no_input = no_field.$wrapper.find( 'input[type="checkbox"]' ); $yes_input.on( 'change', function() { if ( $yes_input.is(':checked') ) { frappe.web_form.set_value( 'citizen_no', 0 ); $no_input.prop( 'checked', false ); frappe.web_form.set_value( 'identity_document_no', '' ); frappe.web_form.set_value( 'identity_document_type', '' ); } refresh_citizenship_dependent_fields(); apply_citizen_dependent_locks(); } ); $no_input.on( 'change', function() { if ( $no_input.is(':checked') ) { frappe.web_form.set_value( 'citizen_yes', 0 ); $yes_input.prop( 'checked', false ); frappe.web_form.set_value( 'national_id_number', '' ); } refresh_citizenship_dependent_fields(); apply_citizen_dependent_locks(); } ); refresh_citizenship_dependent_fields(); apply_citizen_dependent_locks(); } setup_citizenship_checkboxes(); /* ========================================================= CITIZENSHIP PAGE VALIDATION ========================================================= */ function citizenship_page_is_visible() { let yes_field = frappe.web_form.get_field( 'citizen_yes' ); if (!yes_field) { return false; } let $page = yes_field.$wrapper.closest( '.form-page' ); return ( $page.length && $page.is(':visible') ); } function validate_citizenship_before_next() { if ( !citizenship_page_is_visible() ) { return true; } let yes_value = frappe.web_form.get_value( 'citizen_yes' ); let no_value = frappe.web_form.get_value( 'citizen_no' ); if ( !yes_value && !no_value ) { frappe.msgprint({ title: 'Selection Required', message: 'Please indicate whether you are a South African Citizen/Permanent Resident before continuing.', indicator: 'red' }); return false; } return true; } document.addEventListener( 'click', function(e) { if ( e.target.closest( '.btn-next' ) ) { if ( !validate_citizenship_before_next() ) { e.preventDefault(); e.stopPropagation(); e.stopImmediatePropagation(); } } }, true ); /* ========================================================= ATTACHMENT SELECTOR ========================================================= */ /* ========================================================= ATTACHMENT SELECTOR ========================================================= */ function get_attachment_field_map() { return { 'Certified ID Document': 'certified_id_document', 'Certified Passport Document': 'certified_passport_document', 'Certified Asylum Seeker Document': 'certified_asylum_seeker_document' }; } /* Show only the attach field matching the selected option, and clear the ones that are no longer relevant. */ function apply_attachment_visibility(selected) { let field_map = get_attachment_field_map(); Object.keys(field_map).forEach(function (option_label) { let fieldname = field_map[option_label]; let is_selected = (selected === option_label); toggle_dependent_field(fieldname, is_selected); if (!is_selected && frappe.web_form.get_value(fieldname)) { frappe.web_form.set_value(fieldname, ''); } }); } /* Read what the select actually shows right now */ function get_selected_attachment() { let select_field = frappe.web_form.get_field('select_attachment'); if (!select_field) return ''; let dom_value = select_field.$wrapper.find('select').val(); return dom_value || frappe.web_form.get_value('select_attachment') || ''; } /* identity_document_type -> select_attachment mapping (citizen_no only) */ function get_identity_attachment_map() { return { 'Passport': 'Certified Passport Document', 'Asylum Seeker Permit': 'Certified Asylum Seeker Document' }; } /* Read what the identity_document_type select actually shows right now */ function get_identity_document_type() { let field = frappe.web_form.get_field('identity_document_type'); if (!field) return ''; let dom_value = field.$wrapper.find('select').val(); return dom_value || frappe.web_form.get_value('identity_document_type') || ''; } /* Work out what select_attachment must be, or '' if nothing is forced yet */ function get_forced_attachment() { let citizen_yes = frappe.web_form.get_value('citizen_yes'); let citizen_no = frappe.web_form.get_value('citizen_no'); if (citizen_yes) { return 'Certified ID Document'; } if (citizen_no) { return get_identity_attachment_map()[get_identity_document_type()] || ''; } return null; /* null = nothing forced, user chooses freely */ } /* Restrict select_attachment according to citizenship + identity document type */ function apply_attachment_restrictions() { let select_field = frappe.web_form.get_field('select_attachment'); if (!select_field) return; let forced = get_forced_attachment(); let all_options = Object.keys(get_attachment_field_map()); let effective = ''; if (forced === null) { /* Citizenship not chosen yet: free choice */ frappe.web_form.set_df_property( 'select_attachment', 'options', '\n' + all_options.join('\n') ); frappe.web_form.set_df_property('select_attachment', 'read_only', 0); effective = get_selected_attachment(); } else if (forced) { /* Hard set and lock */ frappe.web_form.set_df_property('select_attachment', 'options', forced); frappe.web_form.set_value('select_attachment', forced); frappe.web_form.set_df_property('select_attachment', 'read_only', 1); effective = forced; } else { /* citizen_no but no identity document type chosen yet: lock and blank until they choose one */ frappe.web_form.set_df_property('select_attachment', 'options', ''); frappe.web_form.set_value('select_attachment', ''); frappe.web_form.set_df_property('select_attachment', 'read_only', 1); effective = ''; } if (select_field.refresh) select_field.refresh(); /* Apply immediately with the value we intend... */ apply_attachment_visibility(effective); /* ...and again after Frappe has re-rendered the select */ setTimeout(function () { let f = get_forced_attachment(); apply_attachment_visibility(f === null ? get_selected_attachment() : f); }, 150); } function setup_attachment_selector() { let select_field = frappe.web_form.get_field('select_attachment'); if (!select_field) return; /* Manual changes (only possible when citizenship is not chosen yet) */ select_field.$wrapper .find('select') .on('change', function () { apply_attachment_visibility($(this).val()); }); /* identity_document_type drives select_attachment for non-citizens */ let identity_field = frappe.web_form.get_field('identity_document_type'); if (identity_field) { identity_field.$wrapper .find('select') .on('change', function () { apply_attachment_restrictions(); }); } apply_attachment_restrictions(); } setup_attachment_selector(); /* ========================================================= MANDATORY FIELD VALIDATION FOR CURRENT PAGE ========================================================= */ function validate_mandatory_fields_on_page( $page ) { let missing_labels = []; $page.find('.frappe-control').each( function() { let $control = $(this); let fieldname = $control.attr( 'data-fieldname' ); if (!fieldname) { return; } let $label = $control.find( '.control-label.reqd' ); if (!$label.length) { return; } let value = frappe.web_form.get_value( fieldname ); let is_empty = ( value === undefined || value === null || value === '' ); if (is_empty) { missing_labels.push( $label.text().trim() ); } } ); return missing_labels; } /* ========================================================= REMOTE SELECT SYNC ========================================================= */ let remote_sync_loaded = {}; function setup_remote_select_sync( fieldname, remote_doctype, filters = null ) { let field = frappe.web_form.get_field( fieldname ); if (!field) { return; } let $select = field.$wrapper.find( 'select' ); $select.on( 'focus click', function() { if ( remote_sync_loaded[fieldname] ) { return; } remote_sync_loaded[fieldname] = true; frappe.call({ method: "application_portal.application_portal.doctype.application.application.get_select_field_options", args: { fieldname: fieldname, remote_doctype: remote_doctype, filters: filters }, callback: function(response) { let records = response.message || []; if ( !records.length ) { remote_sync_loaded[ fieldname ] = false; return; } let current_value = frappe.web_form.get_value( fieldname ); let options = '\n' + records.join( '\n' ); frappe.web_form.set_df_property( fieldname, 'options', options ); if (current_value) { frappe.web_form.set_value( fieldname, current_value ); } }, error: function() { remote_sync_loaded[ fieldname ] = false; } }); } ); } /* ========================================================= STUDY TERM SYNC ========================================================= */ function setup_study_term_sync() { let field = frappe.web_form.get_field( 'study_term' ); if (!field) { return; } let study_year = frappe.web_form.get_value( 'study_year' ); if (!study_year) { frappe.web_form.set_value( 'study_term', '' ); frappe.web_form.set_df_property( 'study_term', 'options', '' ); frappe.web_form.set_df_property( 'study_term', 'read_only', 1 ); return; } frappe.web_form.set_df_property( 'study_term', 'read_only', 0 ); let filters = [ [ 'academic_year', '=', study_year ] ]; frappe.call({ method: "application_portal.application_portal.doctype.application.application.get_select_field_options", args: { fieldname: 'study_term', remote_doctype: 'Academic Term', filters: filters }, callback: function(response) { if ( frappe.web_form.get_value( 'study_year' ) !== study_year ) { return; } let records = response.message || []; let options = records.length ? '\n' + records.join('\n') : ''; frappe.web_form.set_df_property( 'study_term', 'options', options ); if ( !records.length ) { frappe.web_form.set_value( 'study_term', '' ); } } }); } /* ========================================================= STUDY YEAR CHANGE ========================================================= */ function setup_study_year_change_handler() { let field = frappe.web_form.get_field( 'study_year' ); if (!field) { return; } let $select = field.$wrapper.find( 'select' ); $select.on( 'change', function() { frappe.web_form.set_value( 'study_term', '' ); remote_sync_loaded[ 'study_term' ] = false; setup_study_term_sync(); } ); } setup_remote_select_sync( 'study_programme', 'Program' ); let current_year = new Date().getFullYear(); function filter_years_from_today(year_strings) { let current_year = new Date().getFullYear(); return year_strings.filter(function(year_str) { let year_num = parseInt(year_str, 10); return !isNaN(year_num) && year_num > current_year; }); } function setup_study_year_sync() { let field = frappe.web_form.get_field('study_year'); if (!field) { return; } let $select = field.$wrapper.find('select'); $select.on('focus click', function() { if (remote_sync_loaded['study_year']) { return; } remote_sync_loaded['study_year'] = true; frappe.call({ method: "application_portal.application_portal.doctype.application.application.get_select_field_options", args: { fieldname: 'study_year', remote_doctype: 'Academic Year' }, callback: function(response) { let records = response.message || []; if (!records.length) { remote_sync_loaded['study_year'] = false; return; } let future_years = filter_years_from_today(records); if (!future_years.length) { remote_sync_loaded['study_year'] = false; return; } let current_value = frappe.web_form.get_value('study_year'); let options = '\n' + future_years.join('\n'); frappe.web_form.set_df_property( 'study_year', 'options', options ); if (current_value && future_years.includes(current_value)) { frappe.web_form.set_value('study_year', current_value); } }, error: function() { remote_sync_loaded['study_year'] = false; } }); }); } setup_study_year_sync(); setup_remote_select_sync( //'guardian_type', 'Relation Type' ); setup_study_term_sync(); setup_study_year_change_handler(); /* ========================================================= STUDY TYPE - FIXED FOR NOW ========================================================= */ function setup_study_type() { let field = frappe.web_form.get_field('study_type'); if (!field) { return; } // Set the value frappe.web_form.set_value( 'study_type', 'Undergraduate' ); // Make the field read-only frappe.web_form.set_df_property( 'study_type', 'read_only', 1 ); // Refresh the field so the change is displayed if (field.refresh) { field.refresh(); } } setup_study_type(); /* ========================================================= NEXT BUTTON - CURRENT PAGE VALIDATION ========================================================= */ document.addEventListener( 'click', function(e) { let $next_btn = $(e.target).closest( '.btn-next' ); if (!$next_btn.length) { return; } /* * Do not interfere while navigating backwards. */ if (is_navigating_back) { return; } let $pages = $('.form-page'); let $current_page = get_visible_form_page(); if (!$current_page.length) { return; } let current_index = $pages.index( $current_page ); /* * If this is not the last page, * validate only the fields on this page. */ if ( current_index < $pages.length - 1 ) { let missing = validate_mandatory_fields_on_page( $current_page ); if (missing.length) { e.preventDefault(); e.stopPropagation(); e.stopImmediatePropagation(); let list_html = missing.map( label => `

${label}

` ).join(''); frappe.msgprint({ title: 'Missing Required Information', message: `Please fill in the following before continuing:

${list_html}`, indicator: 'red' }); return; } } }, true ); /* ========================================================= DEFAULT COMPANY ========================================================= */ frappe.call({ method: "application_portal.api.get_default_company", callback: function(response) { if (response.message) { let $brand = $('.navbar-brand'); $brand.find('span') .text( response.message ); $brand.css( 'visibility', 'visible' ); $brand.on( 'click', function(e) { e.preventDefault(); } ); } } }); /* ========================================================= NAVBAR LOGO ========================================================= */ frappe.call({ method: "application_portal.api.get_navbar_logo", callback: function(response) { if (response.message) { let $brand = $('.navbar-brand'); let $logo = $('', { src: response.message, class: 'navbar-brand-logo', alt: 'Logo' }); $brand.prepend( $logo ); } } }); /* ========================================================= WEB FORM HEADER LOGO ========================================================= */ frappe.call({ method: "application_portal.api.get_navbar_logo", callback: function(response) { if (response.message) { let $header = $('.web-form-header'); let $logo = $('', { src: response.message, class: 'web-form-logo', alt: 'Logo' }); $header.prepend( $logo ); } } }); /* ========================================================= PRESCREENING HEADING ========================================================= */ function update_prescreening_heading() { let title = frappe.web_form.get_value( 'title' ); let first_name = frappe.web_form.get_value( 'first_name' ); let last_name = frappe.web_form.get_value( 'last_name' ); if (!first_name) { return; } let study_type = frappe.web_form.get_value( 'study_type' ); let study_programme = frappe.web_form.get_value( 'study_programme' ); let study_year = frappe.web_form.get_value( 'study_year' ); let $pages = $('.form-page'); let $current_page = get_visible_form_page(); let current_index = $pages.index( $current_page ); $('.prescreening-heading') .remove(); if ( current_index > 0 && $current_page.length ) { let $heading = $('

', { class: 'prescreening-heading' }); let $main_heading = $('

', { class: 'prescreening-main-heading' }); /* * Main heading * * {title} {first_name} {last_name}, * please fill out the remaining fields * to complete your Pre-Screening / $main_heading.append( $('', { class: 'prescreening-parameter', text: title }), ' ', $('', { class: 'prescreening-parameter', text: first_name }), ' ', $('', { class: 'prescreening-parameter', text: last_name }), ', please fill out the remaining fields to complete your Pre-Screening' ); $heading.append( $main_heading ); / * Study Type / if ( current_index > 1 && study_type ) { let $study_type_info = $('
', { class: 'prescreening-application-info' }); $study_type_info.append( 'Application Type: ', $('', { class: 'prescreening-parameter', text: study_type }) ); $heading.append( $study_type_info ); } / * Currently applying for / if ( current_index > 1 && study_programme && study_year ) { let $application_info = $('
', { class: 'prescreening-application-info' }); $application_info.append( 'Currently applying for: ', $('', { class: 'prescreening-parameter', text: study_programme }), ', ', $('', { class: 'prescreening-parameter', text: study_year }) ); $heading.append( $application_info ); } $current_page.prepend( $heading ); } } / ========================================================= PAGE BREAK HEADINGS ========================================================= / function add_page_break_headings() { $('.form-page').each( function() { let $page = $(this); if ( $page.find( '.page-break-heading' ).length ) { return; } let $first_section = $page.find( '.row.form-section' ).first(); if (!$first_section.length) { return; } if ( $first_section.find( '.section-head' ).length ) { return; } let fieldname = $first_section.attr( 'data-fieldname' ); if (!fieldname) { return; } let field = frappe.web_form.get_field( fieldname ); if ( !field || !field.df || !field.df.label ) { return; } let $heading = $('
', { class: 'page-break-heading', text: field.df.label }); $page.prepend( $heading ); } ); } / ========================================================= GET PAGE LABELS ========================================================= / function get_page_break_labels() { let labels = []; $('.form-page').each( function() { let $page = $(this); let $first_section = $page.find( '.row.form-section' ).first(); if (!$first_section.length) { labels.push(null); return; } let fieldname = $first_section.attr( 'data-fieldname' ); if (!fieldname) { labels.push(null); return; } let field = frappe.web_form.get_field( fieldname ); if ( !field || !field.df || !field.df.label ) { labels.push(null); return; } labels.push( field.df.label ); } ); return labels; } / ========================================================= UPDATE NAVIGATION BUTTON LABELS ========================================================= / function update_nav_button_labels() { let $pages = $('.form-page'); let $current_page = get_visible_form_page(); if (!$current_page.length) { return; } let current_index = $pages.index( $current_page ); if (current_index === -1) { return; } let labels = get_page_break_labels(); / * PREVIOUS BUTTON / let $prev_btn = $('.btn-previous'); if (current_index > 0) { let prev_label = labels[current_index - 1]; if (prev_label) { $prev_btn.html( '← ' + prev_label ); } else { $prev_btn.html( '← Previous' ); } } / * NEXT BUTTON * * IMPORTANT: * We do NOT modify .submit-btn here. / let $next_btn = $('.btn-next'); if ( $next_btn.length && current_index < $pages.length - 1 ) { let next_label = labels[current_index + 1]; if (next_label) { $next_btn.html( next_label + ' →' ); } else { $next_btn.html( 'Next →' ); } } } / ========================================================= AFTER PAGE CHANGE ========================================================= / document.addEventListener( 'click', function(e) { if ( e.target.closest( '.btn-next' ) ) { setTimeout( function() { update_prescreening_heading(); add_page_break_headings(); fix_navigation_buttons(); }, 100 ); } }, true ); / ========================================================= REMOVE "SUBMIT ANOTHER RESPONSE" AFTER SUCCESSFUL SUBMIT ========================================================= / function remove_submit_another_response() { / * Frappe shows this after a successful Web Form submission. * * Remove the button/link if it exists. / $('.btn-new').remove(); / * Also remove the surrounding text/container if it * contains "Submit another response". / $('.web-form-footer').find( 'a, button' ).filter(function() { return $(this) .text() .trim() .toLowerCase() .includes( 'submit another response' ); }).remove(); / * Catch any other element containing the text. / $('a, button').filter(function() { return $(this) .text() .trim() .toLowerCase() .includes( 'submit another response' ); }).remove(); } / ========================================================= WATCH FOR SUCCESSFUL SUBMISSION ========================================================= / function watch_for_submission_success() { let observer = new MutationObserver(function() { remove_submit_another_response(); apply_custom_success_message(); }); let target = document.querySelector('.web-form') || document.body; if (target) { observer.observe(target, { childList: true, subtree: true }); } let attempts = 0; let interval = setInterval(function() { remove_submit_another_response(); apply_custom_success_message(); attempts++; if (attempts >= 20) { clearInterval(interval); } }, 250); } / ========================================================= CUSTOM SUCCESS MESSAGE ========================================================= / let organisation_name = ''; frappe.call({ method: "application_portal.api.get_default_company", callback: function(response) { if (response.message) { organisation_name = response.message; apply_custom_success_message(); } } }); function apply_custom_success_message() { let $success_page = $('.success-page'); if (!$success_page.length) return; if (!organisation_name) return; let $title = $success_page.find('.success-title'); let $message = $success_page.find('.success-message'); if ($title.length) { $title.text('Application Submitted'); } if ($message.length) { $message.html(`
Thank you for spending your valuable time to fill this form, Step 1 to applying at ${organisation_name}.

We have received your Screening Application and have emailed you login details to complete the next step. Please check your Junk/Spam folder just in case.

Complete your Application in our Applications Portal using the link we emailed you.

Upload required documentation as indicated in the Applications Portal.

Pay the Application Fee in the Portal. We will then proceed to verify your application and notify you of an outcome.

`); } } / ========================================================= REMOVE CAMERA OPTION FROM ATTACH FIELDS ========================================================= / let camera_removal_enabled = false; // set to true to re-enable function remove_camera_from_attach_fields() { / * Frappe's file uploader is a modal/dialog appended to * , not inside the attach field's own wrapper - * so we search the whole document for it. / if (!camera_removal_enabled) { return; } $('.file-uploader, .modal, .uploader-body') .find('button, a, .btn, [data-action]') .each(function() { let $element = $(this); let text = $element.text() .trim() .toLowerCase(); if (text === 'camera' || text.includes('camera')) { $element.remove(); } }); } / ========================================================= HIDE PRIVATE / OPTIMIZE OPTIONS IN UPLOAD DIALOG ========================================================= / let upload_options_removal_enabled = true; // set to false to re-enable function remove_upload_dialog_options() { if (!upload_options_removal_enabled) { return; } $('.file-uploader, .modal, .uploader-body') .find('.checkbox, label, .form-group') .each(function() { let $element = $(this); let text = $element.text() .trim() .toLowerCase(); if (text === 'private' || text === 'optimize') { $element.hide(); } }); } function force_private_uploads() { $('.file-uploader, .modal, .uploader-body') .find('input[type="checkbox"]') .each(function() { let $checkbox = $(this); let label_text = $checkbox.closest('.checkbox, label, .form-group') .text() .trim() .toLowerCase(); if (label_text.includes('private')) { if (!$checkbox.is(':checked')) { $checkbox.prop('checked', true).trigger('change'); } } }); } / ========================================================= WATCH FOR ATTACHMENT UPLOADER ========================================================= / let camera_observer = new MutationObserver(function() { remove_camera_from_attach_fields(); remove_upload_dialog_options(); force_private_uploads(); }); camera_observer.observe( document.body, { childList: true, subtree: true } ); / ========================================================= INITIAL CHECK ========================================================= / remove_camera_from_attach_fields(); remove_upload_dialog_options(); force_private_uploads(); / ========================================================= INITIAL LOAD ========================================================= */ setTimeout( function() { update_prescreening_heading(); add_page_break_headings(); fix_navigation_buttons(); watch_for_submission_success(); }, 500 );

New Application - Application Form

Submitted