Skip to content
This repository has been archived by the owner on Jan 29, 2020. It is now read-only.
Permalink

Comparing changes

Choose two branches to see what’s changed or to start a new pull request. If you need to, you can also or learn more about diff comparisons.

Open a pull request

Create a new pull request by comparing changes across two branches. If you need to, you can also . Learn more about diff comparisons here.
base repository: lsuits/lsu-block_quickmail
Failed to load repositories. Confirm that selected base ref is valid, then try again.
Loading
base: v1.7.1
Choose a base ref
...
head repository: lsuits/lsu-block_quickmail
Failed to load repositories. Confirm that selected head ref is valid, then try again.
Loading
compare: LSU_37_GRADEBOOK
Choose a head ref
Loading
Showing 309 changed files with 39,647 additions and 8,017 deletions.
8 changes: 7 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
@@ -1 +1,7 @@
phpunit.xml
.DS_Store
node_modules/
.sass-cache/
npm-debug.log
package-lock.json
stuff.txt
testy.php
Empty file removed .gitmodules
Empty file.
Empty file modified CHANGELOG.md
100644 → 100755
Empty file.
32 changes: 32 additions & 0 deletions Gruntfile.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
"use strict";

module.exports = function (grunt) {

// We need to include the core Moodle grunt file too, otherwise we can't run tasks like "amd".
require("grunt-load-gruntfile")(grunt);
grunt.loadGruntfile("../../Gruntfile.js");

// Load all grunt tasks.
grunt.loadNpmTasks('grunt-contrib-uglify');
grunt.loadNpmTasks('grunt-contrib-less');
grunt.loadNpmTasks('grunt-contrib-watch');
grunt.loadNpmTasks('grunt-sass');
grunt.loadNpmTasks('grunt-eslint');
grunt.loadNpmTasks('grunt-stylelint');

grunt.initConfig({
sass: {
dist: {
files: {
'style.css' : 'sass/style.sass'
}
}
},
watch: {
files: '**/*.sass',
tasks: ['sass']
}
});
// The default task (running "grunt" in console).
grunt.registerTask("default", ["sass"]);
};
91 changes: 57 additions & 34 deletions README.md
100644 → 100755
Original file line number Diff line number Diff line change
@@ -1,56 +1,79 @@
# Quickmail
Louisiana State University ITS no longer maintains this Project.

Quickmail is a Moodle block that provides selective, bulk emailing within courses.
# Quickmail (v2)

## Features
Quickmail is a Moodle block plugin that provides selective, bulk messaging for Moodle courses and sites. Developed by Louisiana State University :tiger:, Geaux Tigers!!!

## Overview

* Multiple attachments
* Drafts
* Signatures
* Filter by Role
* Filter by Groups
* Optionally allow Students to email people within their group.
* Alternate sending email
* Embed images and other content in emails and signatures
Quickmail is a convenient way to select enrolled users in your Moodle course and message them. You can select (or exclude) recipients individually, by role, or even by group. Additionally, you can use Quickmail at the administrative level to select and message users within the entire site.

## Download
**Please note that these are the docs for Quickmail v2**. This second version is much different than the original version in the way it operates and saves data. If you are wanting to install the original version, please see the [Quickmail v1 branch](https://github.com/lsuits/block_quickmail/tree/dev-30) of this plugin.

Visit [Quickmail's Github page][quickmail_github] to either download a package or clone the git repository.
It is highly recommended that you review the features below and make sure this plugin will work for you, and that you backup any existing data before installing!!

## Installation

Quickmail should be installed like any other block. See [the Moodle Docs page on block installation][block_doc].
**Note:** In order for this block to send messages you need to have CRON working and running properly on your server. If you don't have CRON running regularly, **do not install** (or upgrade) this block!

## Contributions
Quickmail should be installed like any other block. See the [Moodle Docs page on plugin installation](https://docs.moodle.org/34/en/Installing_plugins#Installing_a_plugin) for more info. You can also find Quickmail on the official [Moodle Plugin Directory](https://moodle.org/plugins/block_quickmail).

Contributions of any form are welcome. Github pull requests are preferred.
If you are upgrading from v1 to v2, a data migration script is included in this plugin which will format your existing data to the new structure. **Note:** Signatures and Alternate Emails are not carried over, however, and will have to be re-created manually.

File any bugs, improvements, or feature requiests in our [issue tracker][issues].
## Features

## License
* **Multiple Message Types**

Quickmail adopts the same license that Moodle does.
Send messages via email OR as [Moodle Messages](http://docs.moodle.org/en/Messaging).

* **Task-based Messaging**

All messages are sent behind the scenes as "ad-hoc tasks" so you don't have to wait around for your message to be sent!

* **Scheduled Sending**

Want your message to go out first thing tomorrow morning? No problem! You can choose the date and time your message will be sent!

## Screenshots
* **Custom User Data Injection**

Want to add a personal touch easily? No problem! Using a handy little helper when composing your message you can have Quickmail automatically inject personal data like first name, last name, email, etc.

![Block][block]
* **Admin-level Messaging**

---
Want to use Quickmail to address your entire site, not just those in a specific course? No problem! Add the Quickmail block to your Dashboard page.

![Email][email]
* **Drafts**

Still working on that email? Save it as a draft to come back to later! You can even duplicate your favorite drafts so you don't have to type them all over again!

---
* **Signatures**

Add a personal touch by creating your own signatures and applying them to your messages!

![Signatures][signature]
* **Mentor Copy**

Send a copy of your message to a recipient's mentor with one click!

---
* **File Attachments**

Attach files to your messages easily! The recipient will see a list of all files and even a zipped version to download. Bonus: you can use nested directories in your attachments as well.

![Configuration][config]
* **Allow Students To Send**

Want to allow students of a particular course to message other students? Configure Quickmail to act like you want, FERPA guidelines can even be taken into account. You make the call!

[quickmail_github]: https://github.com/lsuits/quickmail
[block_doc]: http://docs.moodle.org/20/en/Installing_contributed_modules_or_plugins#Block_installation
[block]: https://tigerbytes2.lsu.edu/users/pcali1/work/block.png
[config]: https://tigerbytes2.lsu.edu/users/pcali1/work/config.png
[signature]: https://tigerbytes2.lsu.edu/users/pcali1/work/signature.png
[email]: https://tigerbytes2.lsu.edu/users/pcali1/work/email.png
[issues]: https://github.com/lsuits/quickmail/issues
* **Additional Emails**

Want to message someone outside of your Moodle through Quickmail? No problem! Just type in their email address and they will receive a copy!

## Contributions

Contributions of any form are welcome. GitHub pull requests are preferred. Report any bugs or requests through our GitHub [issue tracker](https://github.com/lsuits/quickmail/issues).

## Tests

To run PHPUnit tests: `vendor/bin/phpunit -c blocks/quickmail/phpunit.xml`

## License

Quickmail adopts the same license that Moodle does.
240 changes: 0 additions & 240 deletions admin_email.php

This file was deleted.

Loading