WP Manifestindependent plugin directory
manifest / developer / rf-site-functionality

Site Functionality

File-based WordPress code snippets, stored outside the plugin.

by Matt Cromwell · github.com/roots-and-fruit/rf-site-functionality · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/roots-and-fruit/rf-site-functionality/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/roots-and-fruit/rf-site-functionality ↗

A file-based code snippet system for WordPress that loads and executes PHP files with better performance and security than database-stored snippets.

🚀 Why Site Functionality?

Performance Benefits

  • File-based storage - No database queries for snippet loading
  • Early loading - Unconditional PHP runs on plugins_loaded at priority 5. Plugin files are already loaded. The theme is not. A snippet can attach to a hook that fires later. It should not call a plugin function, or remove a callback, until that plugin has registered it.
  • Caching friendly - Files don't change frequently, perfect for caching
  • Zero database overhead - Snippets stored as PHP files

Developer Experience

  • In-browser editor with CodeMirror syntax highlighting
  • Real-time validation and error checking
  • Enable/disable snippets without deleting files
  • Template system for quick snippet creation
  • Comprehensive error handling and logging

Security Features

  • Path traversal protection
  • File validation before loading
  • Restricted execution to .php files only
  • Error logging when WP_DEBUG is enabled

📦 Installation

  1. Upload the plugin to /wp-content/plugins/rf-site-functionality/
  2. Activate the plugin through the WordPress admin
  3. Access "Site Functionality" under the Plugins menu
  4. Create your first snippet. It is saved in wp-content/mc-snippets/

🛠️ Quick Start

Creating Your First Snippet

  1. Go to Plugins → Site Functionality in your WordPress admin
  2. Click "Create New Snippet"
  3. Write your PHP code:
<?php
// Add a custom shortcode
add_shortcode( 'hello_world', function( $atts ) {
    return '<div>Hello from Site Functionality!</div>';
} );

// Hook into WordPress actions
add_action( 'wp_footer', function() {
    echo '<!-- Custom footer content -->';
} );
  1. Save and your snippet is immediately active!

File-Based Snippets

Snippet files live in wp-content/mc-snippets, or in the directory you set with RF_SITE_FUNCTIONALITY_SNIPPETS_DIR. A browser cannot run the PHP. The code is stored as .mcphp, which PHP does not execute on a direct request, and the file starts with an ABSPATH exit if a server runs it anyway. Apache and IIS are also told to refuse the folder, so those servers do not return the source. The editor and the Abilities API still call a snippet example.php.

On WordPress 6.9 or newer, the same files are available through the Abilities API: list, read, create, update, enable, disable, and delete. Administrators receive read_mc_snippets, edit_mc_snippets, and delete_mc_snippets on upgrade. A new file is saved disabled until it is enabled.

wp-content/mc-snippets/
├── custom-shortcodes.php
├── theme-modifications.php
├── admin-customizations.php
└── performance-optimizations.php

🎯 Use Cases

  • Custom shortcodes and functions
  • Theme modifications and customizations
  • Admin interface enhancements
  • Performance optimizations
  • Security hardening measures
  • Third-party integrations

🔧 Features

  • ✅ File-based snippet storage
  • ✅ In-browser code editor
  • ✅ Enable/disable snippets
  • ✅ Syntax highlighting
  • ✅ Error validation
  • ✅ Template system
  • ✅ Security protection
  • ✅ Performance optimized

🤝 Contributing

We welcome contributions! Here's how you can help:

Reporting Issues

  • 🐛 Bug reports - Help us improve the plugin
  • 💡 Feature requests - Suggest new functionality
  • 📚 Documentation - Help improve our docs

Submitting Pull Requests

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Development Guidelines

  • Follow WordPress coding standards
  • Add proper documentation
  • Include tests for new features
  • Update README if needed

📄 License

This project is licensed under the GPL v2 or later - see the LICENSE.txt file for details.

🙏 Support

⭐ Star This Repository

If you find this plugin useful, please consider giving it a star on GitHub. It helps others discover the project!

Built with ❤️ for the WordPress community