Skip to content

Latest commit

 

History

History
127 lines (104 loc) · 6.27 KB

README.md

File metadata and controls

127 lines (104 loc) · 6.27 KB
Raw

Mobius Forms Builder 6 App for .net CMSs

This is a 2sxc App for DNN ☢️ and Oqtane 💧

This Mobius Forms App is an add-on to DNN. It is the most customizable Form extension in the DNN ecosystem.

Aspect Status Comments or Version
2sxc ✅ requires 2sxc v17.07.00
Dnn ✅ For v9.6.1
Oqtane ✅ Requires v5.00
No jQuery ✅
Live Demo ➖
Install Checklist ✅ See Installation on azing.org
Source & License ✅ included, ISC/MIT
App Catalog ✅ See app catalog
Screenshots ✅ See app catalog
Best Practices ✅ Uses v16.01 conventions
Bootstrap 3 ✅ optimized
Bootstrap 4 ✅ optimized
Bootstrap 5 ✅ optimized

This means that it

  1. can be used to create a simple contact form in one minute
  2. can be modified to be any other form you need
  3. can be used as a starting point for your own AJAX forms in DNN

The app is built with the pattern Don't be DAFT (DAFT = Densely Abstract Features for Techies), aka the Anti-Abstraction pattern. So customizing it is mostly done using common technologies like HTML, JS and some C#.

Quick Intro To The Mobius Forms App for DNN

A DNN App is like a DNN module, just way better 😉. Since this is an open-code/open-source 2sxc-app, you can customize it to be anything you want! This list just shows what it already does, so you know what you get out-of-the-first-box.

  1. Pre-Built Forms for use or learning
    1. Basic contact form with Subject, Message, Name, E-Mail
    2. A support-request form with a dropdown-example
    3. An example with JS show/hide logic and saving raw JSON-data
  2. Form builder to add/change fields as you wish without requiring development
  3. Ability to completely re-program how fields are generated
  4. AJAX, so no page reloads for validation, sending or messages
  5. Recaptcha (optional) validation on client and server
  6. data is saved, together with the Timestamp, SenderIP, optionaly generated Title or even raw JSON-data
  7. sends various e-mails, which are razor-templateable and has Reply-To and CC options
  8. multi-language labels and messages, already translated into English and German/Deutsch
  9. field validation uses html5 and pristinejs and works with multiple forms on the same page
  10. you can easily review / manage / filter the submitted items in a table-view
  11. export all submissions into an Excel-compatible XML format
  12. open code C# WebApi easy to customize if you ever need to

Because it's so simple and uses 2sxc, you can easily

Get Started

This app is only useful is you use DNN or Oqtane. So assuming you have a DNN installation, all you need to do is install 2sxc and this app.

  • Here's how to install 2sxc and an App of your Choice

  • Now you can use this app as-is, or customize it to be whatever you need it to be.

  • It probably helps to review the Overview about how the parts play together by default, so you can then change as little as necessary to get it to do what you want

Customize the App

The Source Code is all here - so you can easily customize to your hearts desire!

History

  • 2021-11
    • Updated to v12 best-practices
    • Removed all jQuery dependencies
    • Hybrid - now works in Dnn and Oqtane
  • 2022-03
    • Added web.config with required assemblies
  • v05.04.00 2022-04
    • Changed all access to services to ToSic.Sxc.Services
    • Changed instances of Edit.Enable to page.Activate()
    • Changed uses of the Eav.Configuration.IFeaturesService to Sxc.Services.IFeaturesService
    • Updated JS to use new webapi methods (fetch -> fetchRaw)
  • v05.05.00 2022-06
    • Replaced all base classes with their 2sxc 14 equivalents
    • Replaced all GetService<> with the new ServiceKit14
    • Updated webpack
    • Updated all toolbar configurations to use the IToolbarService
  • v05.05.01 2022-08
    • Fixed the warning messages for the forms
  • v05.06.00 2023-05
    • Removed _ from Filenames
    • Replaced turnOn Tag with Kit.Page.TurnOn
    • Change Replace("p", ...) to Kit.Scrub()
    • New FieldBuilder for Checkboxes
  • v05.07.00 2023-06
    • Updated to 16.02 conventions
    • All Razor code now fully typed
  • v06.17.01
    • E-Mail Security improvement
  • v06.17.02
    • Use new Builder.Kit.HtmlTags instance of Tag.Div
    • Refactor Code to functional
  • v06.18.00
    • Finished 2sxc 17 Tags conventions (functional)
    • Added Tokens for default text to allow QueryString, User etc. properties
    • Made default-text field multiline (2 lines by default, stretchable)