Skip to content

ibrahim317/enhanced_kanban_view

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

9 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎯 Enhanced Kanban View

A powerful custom Frappe app that extends Kanban view functionality with advanced features for better workflow management and data validation. Inspired by Bitrix24's Kanban board system.

✨ Features

πŸ”— Link Field-Based Kanban Boards

  • Automatically creates columns based on Link fields in your DocTypes
  • Auto-syncs columns when linked records are created, renamed, or deleted

πŸ“‹ Column Rules & Validation

  • Define required fields for specific columns
  • Show validation dialogs when moving cards between columns
  • Auto-revert cards if validation fails

🎨 Enhanced User Experience

  • Quick Entry Dialogs with field validation
  • Smart field detection for rules
  • Seamless Frappe integration

πŸš€ Installation

bench get-app https://github.com/ibrahim317/enhanced_kanban_view.git
bench --site your-site.com install-app enhanced_kanban_view
bench build

πŸ“– Quick Start

1. Create Link Field-Based Kanban

  1. Navigate to your DocType's List view
  2. Click Kanban β†’ "New Kanban Board"
  3. Select your Link field
  4. Columns auto-create based on linked records

2. Set Up Column Rules

  1. Go to Kanban View > Menu > Create Kanban Board Rule
  2. Choose target column
  3. Add required fields in the "Required Fields" table

3. Validation Behavior

  • Moving cards to columns with rules opens validation dialog
  • Fill required fields to proceed
  • Failed validation returns card to original position

πŸŽ₯ Demo & Tutorial

Enhanced Kanban View Demo

πŸ“Ί Watch the full demo and tutorial: Enhanced Kanban View Features & Usage

πŸ—οΈ Architecture

Core Components

  • Kanban Board Rule: Defines validation rules for columns
  • Kanban Rule Field: Child table for required fields
  • Monkey Patches: Handle automatic column CRUD operations
  • API Endpoints: Field validation and board configuration

Database Schema

Kanban Board Rule: {
  "kanban_board": "Link to Kanban Board",
  "kanban_board_column": "Link to Kanban Board Column", 
  "required_fields": "Table: Kanban Rule Field"
}

Kanban Rule Field: {
  "field_doctype": "Select: DocField|Custom Field",
  "field_name": "Select: Available Fields"
}

πŸ”§ Configuration

  • Hooks: CSS/JS, Monkey Patches, Document Events
  • Permissions: System Manager access by default
  • Customization: Standard and Custom Field support

πŸ› Troubleshooting

Common Issues

  • Columns not updating: Check linked DocType permissions and Link field config
  • Validation dialogs missing: Verify Kanban Board Rules configuration
  • Performance issues: Monitor database queries and consider indexing

🀝 Contributing

  1. Fork the repository
  2. Create feature branch
  3. Make changes and test
  4. Submit pull request

πŸ“„ License

MIT License - see LICENSE

πŸ™ Acknowledgments

  • Bitrix24 - Design inspiration
  • Frappe Framework team
  • All contributors

πŸ“ž Support

  • πŸ“§ Email: i.aboelsoud21@gmail.com
  • πŸ› Issues: GitHub issues
  • πŸ“– Docs: Code comments and docstrings

Made with ❀️ for the Frappe/ERPNext community

About

Frappe Kanban boards with Link field columns, validation dialogs, and automatic synchronization. Inspired by Bitrix24's workflow system.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors