# Contributing to INFORTREAT BIM Viewer

Thank you for considering contributing to the INFORTREAT BIM Viewer! This project is part of academic research on Early Modern fortifications, and we welcome contributions from the heritage, architecture, and web development communities.

## How Can I Contribute?

### Reporting Bugs

If you find a bug, please provide us:
- A clear, descriptive title
- Steps to reproduce the problem
- Expected vs. actual behavior
- Screenshots if applicable
- Your WordPress version and browser info

### Suggesting Enhancements

Feature suggestions are welcome! Please include:
- A clear description of the proposed feature
- Use case: How would it benefit users?
- Example: Show how it would work


## Code Guidelines

### JavaScript
- Use ES6+ features  
- Prefer `const` and `let` over `var`
- Use arrow functions for callbacks
- Add JSDoc comments for functions

### PHP
- Follow WordPress Coding Standards
- Sanitize and escape all user input
- Use WordPress core functions when available

### CSS
- Use CSS variables for theming
- Keep selectors specific to avoid conflicts
- Comment color choices and layout decisions

## Testing

Before submitting:
- Test on WordPress 5.x and 6.x
- Check in Chrome, Firefox, and Safari
- Ensure mobile responsiveness
- Verify no console errors

## License

By contributing, you agree that your contributions will be licensed under the AGPLv3 license, matching the xeokit-sdk requirement.

## Credits

Contributors will be acknowledged in the project README.

## Questions?

Feel free to open an issue with the "question" label!

---

**Thank you for helping preserve cultural heritage through open-source technology!** 🏰
