Download the PHP package made-by-bramble/craft-ecards without Composer
On this page you can find all versions of the php package made-by-bramble/craft-ecards. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package craft-ecards
eCards by Bramble
A powerful and flexible eCards plugin for Craft CMS that integrates with Craft Commerce to provide digital greeting card functionality for your e-commerce store.
Features
🎨 Design Management
- Create and manage multiple eCard designs through an intuitive control panel
- Upload custom images for each design
- Use custom email templates for each design
- Support for multiple designs per product
💌 eCard Management
- Central management dashboard for all sent and scheduled eCards
- View, resend, and delete eCards
- Track sent and scheduled eCards
- Search and filter capabilities
🛍️ Commerce Integration
- Seamless integration with Craft Commerce
- Automatic eCard processing after order completion
- Custom field type for products for easy setup and management
- Validates eCard information during checkout
⏰ Scheduling System
- Schedule eCards for future delivery
- Automated sending at specified dates and times
- Queue-based processing for reliable delivery
- Retry functionality for failed sends
📧 Email Features
- Customizable email templates
- Support for HTML email designs
- Personalized messages
- Responsive email layouts
🔧 Developer Features
- Custom field type for flexible implementation
- Template variables for frontend integration
Requirements
- Craft CMS 5.5.0 or later
- Craft Commerce 5.2.0 or later
- PHP 8.2 or later
Installation
You can install this plugin from the Plugin Store or with Composer.
From the Plugin Store
Go to the Plugin Store in your project's Control Panel and search for "eCards by Bramble". Then click "Install".
With Composer
Open your terminal and run the following commands:
Configuration
After installation, you can configure the plugin through the Control Panel under Settings → eCards by Bramble.
Usage
Creating eCard Designs
- Navigate to eCards by Bramble → Designs in the Control Panel
- Click "New Design"
- Upload your design image
- Configure the email template if required. If left blank, the default email template will be used.
- Save your design
Adding eCards to Products
- Edit your product type
- Add the "Ecard Multi Design" field type and give it a suitable handle
- Assign designs to your products
Updating Your Product Page
The plugin requires that you specify several options when adding your products to the cart.
- designId - The element ID of the design you want to use (required)
- senderName - The name of the sender (required)
- recipientName - The name of the recipient (required)
- recipientEmail - The email address of the recipient (required)
- message - The message to include in the eCard (required)
- sendAt - The date and time to send the eCard (optional)
For convenience, a function has been added to the EcardMultiDesignField class that will generate the necessary HTML for the designId for you. Ensure you replace the field handle with the handle you gave your field.
Alternatively, you can build your own HTML. As long as you pass through all of the required options, the plugin will handle the rest.
The sendAt field is a date picker field. If you want to send the eCard immediately, you can set the date to today or leave it blank.
Validating eCard Information
The plugin will automatically validate the eCard information when the product is added to the cart. If the information is not valid, an array of errors will be added to the order and the add to cart will fail. You can then use the craft.commerce.carts.cart.errors function to access and display the errors to the user.
Managing eCards
- Navigate to eCards by Bramble → Manager
- View all sent and scheduled eCards
- Search and filter eCards
- Resend or delete eCards as needed
Order Processing
The plugin automatically processes eCards when an order is completed:
- Validates eCard information
- Schedules delivery based on specified date
- Sends confirmation to sender
- Delivers eCard to recipient
Scheduled eCards
The plugin can automatically send scheduled eCards. To enable this behaviour you must create a cron job that calls the index method of the CronController class. This is an example of how you can do this in a Linux environment:
This will run the cron job every minute. You can adjust the frequency as needed.
Support
For support, please contact [email protected]
License
This plugin requires a commercial license which can be purchased through the Craft Plugin Store.
