@extends('backend.landings.layout') @section('title', __('Custom Landing Guide')) @section('sub_title', __('How Custom Landing Works')) @section('sub_subtitle', __('Admin guide for uploading, validating, previewing, and publishing landing pages.')) @section('sub_action')

@endsection @section('sub_content') @php $variableRows = [ ['name' => '{app_name}', 'description' => 'Configured application name.', 'example' => 'ZilitPay'], ['name' => '{folder}', 'description' => 'Published landing folder name.', 'example' => 'virtual-card-landing-123'], ['name' => '{home_url}', 'description' => 'Public homepage URL.', 'example' => '/'], ['name' => '{user_login_url}', 'description' => 'User login page URL.', 'example' => '/login'], ['name' => '{user_register_url}', 'description' => 'User registration page URL.', 'example' => '/register'], ['name' => '{user_dashboard_url}', 'description' => 'Authenticated user dashboard URL.', 'example' => '/user/dashboard'], ['name' => '{user_wallet_url}', 'description' => 'User wallet page URL.', 'example' => '/user/wallet/list'], ['name' => '{user_deposit_url}', 'description' => 'Deposit money page URL.', 'example' => '/user/deposit/create'], ['name' => '{user_send_money_url}', 'description' => 'Send money page URL.', 'example' => '/user/send-money/create'], ['name' => '{user_support_url}', 'description' => 'Support ticket page URL.', 'example' => '/user/support-ticket'], ['name' => '{merchant_login_url}', 'description' => 'Merchant login page URL.', 'example' => '/merchant/login'], ['name' => '{merchant_register_url}', 'description' => 'Merchant registration page URL.', 'example' => '/merchant/register'], ['name' => '{agent_login_url}', 'description' => 'Agent login page URL.', 'example' => '/agent/login'], ['name' => '{agent_register_url}', 'description' => 'Agent registration page URL.', 'example' => '/agent/register'], ]; $actionRows = [ ['name' => 'user-login', 'target' => 'Login CTA', 'use' => 'Send visitors to the user login page.'], ['name' => 'user-register', 'target' => 'Registration CTA', 'use' => 'Start a new user account flow.'], ['name' => 'user-dashboard', 'target' => 'Dashboard CTA', 'use' => 'Take authenticated users to the dashboard.'], ['name' => 'user-wallet', 'target' => 'Wallet CTA', 'use' => 'Open the user wallet area.'], ['name' => 'user-deposit', 'target' => 'Deposit CTA', 'use' => 'Route visitors to the deposit money flow.'], ['name' => 'user-send-money', 'target' => 'Send Money CTA', 'use' => 'Route visitors to the send money flow.'], ['name' => 'user-support', 'target' => 'Support CTA', 'use' => 'Open support ticket access.'], ['name' => 'merchant-login', 'target' => 'Merchant Login', 'use' => 'Send merchants to their login page.'], ['name' => 'merchant-register', 'target' => 'Merchant Signup', 'use' => 'Start merchant onboarding.'], ['name' => 'agent-login', 'target' => 'Agent Login', 'use' => 'Send agents to their login page.'], ['name' => 'agent-register', 'target' => 'Agent Signup', 'use' => 'Start agent onboarding.'], ['name' => 'home', 'target' => 'Home', 'use' => 'Return visitors to the public homepage.'], ]; @endphp

@lang('International Guide')

@lang('Build campaign landings that connect directly to ZilitPay product flows.')

@lang('Use variables for stable URLs, action names for smart buttons, and the upload validator to publish a secure static landing as the public homepage.')

@lang('Variables') @lang('Use placeholders such as {user_login_url} and {user_register_url}.')

@lang('Action Bridge') @lang('Use data-dk-action for login, signup, dashboard, wallet, and support buttons.')

@lang('Safe Publishing') @lang('Every uploaded bundle is validated before replacing the live homepage.')

@lang('Quick Start')

@lang('Recommended Workflow')

@lang('Prepare the ZIP Bundle')

@lang('Keep index.html at the ZIP root and organize CSS, JavaScript, images, and fonts in clear folders.')

/index.html
/css/style.css
/js/app.js
/images/hero.webp

@lang('Add Variables')

@lang('Use URL placeholders for CTA links that must stay valid across environments.')

<a href="{user_register_url}">
  Create Account
</a>

@lang('Add Smart Actions')

@lang('Use data-dk-action when a button should be handled by the landing action bridge.')

<button data-dk-action="user-login">
  Login
</button>

@lang('Preview and Activate')

@lang('Preview responsive layout, CTA routes, assets, and browser console output before activation.')

@lang('Reference')

@lang('Variables and Action Names')

@lang('Variable Reference')

@lang('Use these placeholders in href values, copy, or asset paths. The compiler replaces them during upload or HTML save.')

@lang('Supported placeholder formats') {user_login_url} @{{user_login_url}} @{{ user_login_url }}

@foreach($variableRows as $row) @endforeach

@lang('Variable')	@lang('Purpose')	@lang('Example')
`{{ $row['name'] }}`	{{ __($row['description']) }}	{{ $row['example'] }}

@lang('Action Name Reference')

@lang('Use action names with data-dk-action. The bridge script resolves the correct app route and handles the click.')

@foreach($actionRows as $row) @endforeach

@lang('Action')	@lang('CTA Type')	@lang('Recommended Use')
`{{ $row['name'] }}`	{{ __($row['target']) }}	{{ __($row['use']) }}

@lang('Examples')

@lang('Implementation Patterns')

@lang('Primary Campaign CTA')

@lang('Best for hero buttons and repeated signup links.')

<a class="cta-primary"
   href="{user_register_url}"
   data-dk-action="user-register">
  Create Account
</a>

@lang('Authenticated Feature CTA')

@lang('Best for product campaigns that point existing users to a specific feature.')

<button data-dk-action="user-deposit">
  Deposit Now
</button>

<button data-dk-action="user-send-money">
  Send Money
</button>

@lang('Asset Path Convention')

@lang('Use the folder variable for assets published inside the landing folder.')

<link rel="stylesheet"
  href="/custom-landings/{folder}/css/style.css">

<script src="/custom-landings/{folder}/js/app.js"></script>

@lang('Security Guardrails')

@lang('Only approved static file types are accepted.')
@lang('Traversal paths, hidden dotfiles, PHP files, and unsafe links are rejected.')
@lang('Existing files are replaced only after the new bundle passes validation.')
@lang('Security headers are applied when the homepage serves a custom landing.')

@lang('Homepage Resolution')

@lang('If an active landing has index.html, the root URL (/) displays the custom campaign.')
@lang('If no landing is active, the regular CMS homepage flow continues.')
@lang('Deleting a landing also removes its published folder.')

@lang('Bridge Behavior')

@lang('The bridge script is injected automatically during upload and HTML save.')
@lang('Existing bridge markup is replaced so duplicate scripts are not created.')
@lang('Unknown action names are marked with data-dk-action-missing for debugging.')

@lang('Best Practice')

@lang('Production Readiness Checklist')

@lang('Check desktop, tablet, and mobile layouts.') @lang('Verify CTA links such as /register, /login, or campaign-specific routes.') @lang('Optimize image weight before upload.') @lang('Confirm that variables are replaced and action buttons navigate correctly.') @lang('Check browser console, image, CSS, and JavaScript paths.') @lang('Publish only trusted HTML and JavaScript because the page runs on your domain.')

@endsection