Advertising events - Revision history

Pm2022: /* Debugging: */

2026-08-26T06:46:44Z

Debugging:

← Older revision		Revision as of 06:46, 26 August 2026
Line 84:		Line 84:
	<li>Once the Director of Studies/Teaching have sent it, disable Google Campaign Tracking then click '''Send''' on the SU page.</li></ol></li></ol>		<li>Once the Director of Studies/Teaching have sent it, disable Google Campaign Tracking then click '''Send''' on the SU page.</li></ol></li></ol>

	==== Debugging: ====		==== Debugging ====

	# If Java throws an error not related to the tool, debug it using your favourite search engine.		# If Java throws an error not related to the tool, debug it using your favourite search engine.

Pm2022: make generic, not just bcss

2026-08-26T06:46:15Z

make generic, not just bcss

← Older revision		Revision as of 06:46, 26 August 2026
Line 5:		Line 5:
	== Emails ==		== Emails ==

	We need to send emails via both the department and the SU, ~~such~~ that everyone gets them. A lot of ~~computer science~~ students show up to ~~our~~ events despite not being members, so it’s important to include everyone. However, we don’t want to send the same email to anyone twice. ~~We send~~ emails to all computer science students via the Directors of Studies/Teaching, and then to all remaining members via the SU website.		Most societies need to send emails to their members, but departmental societies have a particularly hard time. They need to send emails via both the department and the SU, so that everyone gets them. A lot of departmental students show up to events despite not being members of the SU society, so it’s important to include everyone. However, you don’t want to send the same email to anyone twice. This method allows sending emails to all computer science students via the Directors of Studies/Teaching, and then to all remaining members via the SU website.

	== Using the templating system ==		=== Using the templating system (optional) ===

			{{Note\|text=This section is designed for use by Bath Computer Science Society, and is not necessary for other societies}}

			To ensure we include the correct sponsors' logos, we use a standard template. Steps to use it are below:

	# Download the templating tool		# Download the templating tool
Line 25:		Line 29:
	The [https://www.thesubath.com/resources/thesu/SU-Committee-member-web-tools-guide/ committee web tools] document has a detailed explanation of how to send an email via the SU website. It also has some basic debugging steps.		The [https://www.thesubath.com/resources/thesu/SU-Committee-member-web-tools-guide/ committee web tools] document has a detailed explanation of how to send an email via the SU website. It also has some basic debugging steps.

	For ~~BCSS~~, the process is slightly more complicated. ~~We don’t want~~ to ~~send~~ emails to any ~~Computer Science~~ students via the SU, as they will receive the email from the Directors of Studies/Teaching. The SU doesn’t have any way to filter these, so it has to be done manually, following these steps:		For departmental societies, the process is slightly more complicated. The idea is to avoid sending emails to any students from the department via the SU, as they will receive the email from the Directors of Studies/Teaching. The SU doesn’t have any way to filter these, so it has to be done manually, following these steps. They explain how to send arbitrary HTML (via the Source button) but you can skip that bit and just write a normal email if using HTML is too complicated.

	<ol style="list-style-type: decimal;">		<ol style="list-style-type: decimal;">
Line 80:		Line 84:
	<li>Once the Director of Studies/Teaching have sent it, disable Google Campaign Tracking then click '''Send''' on the SU page.</li></ol></li></ol>		<li>Once the Director of Studies/Teaching have sent it, disable Google Campaign Tracking then click '''Send''' on the SU page.</li></ol></li></ol>

	Debugging:		==== Debugging: ====

	# If Java throws an error not related to the tool, debug it using your favourite search engine.		# If Java throws an error not related to the tool, debug it using your favourite search engine.
Line 87:		Line 91:
	=== Via the Director of Studies/Teaching ===		=== Via the Director of Studies/Teaching ===

	Send an email to ~~Zack Lyons~~ or ~~John Benardis, both are happy to send (relevant) emails to~~ the ~~entire~~ department. ~~Zack is often really busy so John~~ has ~~been more responsive lately~~. ~~It is worth noting Fabio sends emails targetted at PG~~-~~T students~~.		Send an email to the relevant Director of Teaching or Director of Studies for the department you are targeting. The university has a [https://www.bath.ac.uk/teams/list-of-directors-of-studies-by-department/ list of Directors of Studies]. The following steps let you send arbitrary HTML, but you can also just write an email if that's too complicated.

	<ol style="list-style-type: decimal;">		<ol style="list-style-type: decimal;">
	<li><p>Ensure the email HTML is in your clipboard by running the [[#using-the-templating-system\|templator]].</p></li>		<li><p>Ensure the email HTML is in your clipboard by running the [[#using-the-templating-system\|templator]].</p></li>
	<li><p>Open [https://outlook.office.com/mail/ Outlook on the Web].</p></li>		<li><p>Open [https://outlook.office.com/mail/ Outlook on the Web].</p></li>
	<li><p>Compose a new email to ~~Zack Lyons. ([mailto:zl221@bath.ac.uk zl221@bath.ac.uk])~~ or ~~John Benardis ([mailto:ib322@bath.ac.uk ib322@bath.ac.uk])~~.</p></li>		<li><p>Compose a new email to the relevant Director of Studies or Director of Teaching.</p></li>
	<li><p>Type an introduction just saying hi and asking them to forward the below email to students (specify whether it is for UG, PG-T or PG-R).</p></li>		<li><p>Type an introduction just saying hi and asking them to forward the below email to students (specify whether it is for UG, PG-T or PG-R).</p></li>
	<li><p>Where you want the email to go, type the word “test”.</p></li>		<li><p>Where you want the email to go, type the word “test”.</p></li>
Line 108:		Line 112:
	== Instagram ==		== Instagram ==

	{{~~Note\|text=This section is a work~~ in progress.}}		{{Work in progress}}

	* Make sure that any Instagram posts have alt-text and a useful caption. Make sure that all information in the photo is duplicated in the caption.		* Make sure that any Instagram posts have alt-text and a useful caption. Make sure that all information in the photo is duplicated in the caption.

	== WhatsApp ==		== WhatsApp ==

Hw2210: Translate from boss.bathcs.com (written by Penn Mckintosh - pm2022)

2026-06-04T07:41:18Z

Translate from boss.bathcs.com (written by Penn Mckintosh - pm2022)

New page

{{Note|text=
The information in this page may only be applicable to SU-affiliated departmental societies. Other events can be advertised through subsets of the methods on this page.
}}

== Emails ==

We need to send emails via both the department and the SU, such that everyone gets them. A lot of computer science students show up to our events despite not being members, so it’s important to include everyone. However, we don’t want to send the same email to anyone twice. We send emails to all computer science students via the Directors of Studies/Teaching, and then to all remaining members via the SU website.

== Using the templating system ==

# Download the templating tool
## Install [https://www.php.net/manual/en/install.php PHP 8 (command line setup)] and [https://wiki.python.org/moin/BeginnersGuide/Download Python 3]
## Download the latest .zip file from [https://gitlab.bath.ac.uk/cs/bcss/su-mail/-/releases su-mail releases]
## Extract the downloaded file into a folder
# Create an email
## Copy one of the existing emails from the emails folder and increment the number in the filename
## Edit the content of the email
## Make sure to put <code>rel="noopener noreferer"</code> when using <code><a></code> tags
# Generate the email
## Run <code>python main.py emails/xyz.json</code>
## The email’s HTML should be in your clipboard as well as output in the terminal

=== Via the SU ===

The [https://www.thesubath.com/resources/thesu/SU-Committee-member-web-tools-guide/ committee web tools] document has a detailed explanation of how to send an email via the SU website. It also has some basic debugging steps.

For BCSS, the process is slightly more complicated. We don’t want to send emails to any Computer Science students via the SU, as they will receive the email from the Directors of Studies/Teaching. The SU doesn’t have any way to filter these, so it has to be done manually, following these steps:

<ol style="list-style-type: decimal;">
<li>Download the exclusion tool
<ol style="list-style-type: decimal;">
<li>Download the latest .jar file from [https://gitlab.bath.ac.uk/cs/bcss/su-members/-/releases the su-exclude releases page found here]</li>
<li>Ensure you have Java Runtime 1.8 or higher installed</li></ol></li>
<li>Download the sales report
<ol style="list-style-type: decimal;">
<li>Open [https://www.thesubath.com/organisation/salesreports/6566/ the SU’s sales report page].</li>
<li>Set the '''Start date''' to 01/08/YYYY (where YYYY is set so that 01/08/YYYY is within the last year). Make sure that the '''End date''' is in the future (this should be the default).</li>
<li>Click '''Purchasers report'''.</li>
<li>Scroll down and click the '''Save''' icon:
[[File:events-save.png|Save button to the left of a printer icon]]
</li>
<li>Select '''XML file with report data''':
[[File:events-xml.png|Text in the center showing XML file with report data]]
</li>
<li>Download and '''save''' the XML file in your Downloads folder.</li></ol></li>
<li>Connect to the Intranet
<ol style="list-style-type: decimal;">
<li>Either go to campus and connect to eduroam, or</li>
<li>[https://connect.bath.ac.uk/ Connect to the University VPN]</li></ol></li>
<li>Run the tool
<ol style="list-style-type: decimal;">
<li>Put the downloaded JAR and downloaded XML in the same folder/directory</li>
<li>Open a command prompt/terminal in that folder/directory</li>
<li>Run <code>java -jar suexclude-<VERSION>.jar "Product Purchasers Report (System).xml" --deduplicate --include-product 10000610 --exclude-ou DEP-COMP</code>, adjusting filenames as necessary. This step can take a long time to complete, please be patient! If it hangs, you probably forgot to connect the VPN/connect eduroam on campus. If the VPN is connected or you are on the campus Intranet, then please just wait, it will load eventually!</li>
<li>Copy the output to the clipboard (it should be valid JavaScript, otherwise there was an error).</li></ol></li>
<li>Delete the report file
<ol style="list-style-type: decimal;">
<li>Make sure to delete the Product Purchasers Report from your computer.</li>
<li>Clear the recycle bin!</li></ol></li>
<li>Set recipients
<ol style="list-style-type: decimal;">
<li>Open [https://www.thesubath.com/organisation/messages/6566/ the SU messages page].</li>
<li>Create or open a draft.</li>
<li>Click '''Add recipients'''.</li>
<li>Open DevTools using '''Ctrl+Shift+C'''.</li>
<li>If necessary, press '''Escape''' to show the JavaScript console.</li>
<li>Paste the output of the tool into the JavaScript console prompt.</li>
<li>Close DevTools.</li>
<li>Click '''Add recipients'''.</li></ol></li>
<li>Clear your clipboard
<ol style="list-style-type: decimal;">
<li>Copy some non-confidential text.</li>
<li>If you use a clipboard manager, make sure to clear that too.</li></ol></li>
<li>Write your email
<ol style="list-style-type: decimal;">
<li>Paste the HTML from the [[#using-the-templating-system|templator]] into the Source input.</li>
<li>Click '''Save as draft'''.</li>
<li>Once ready, let another committee member '''double-check''' your email.</li>
<li>Send the same email via the Director of Studies/Teaching and wait for them to forward it.</li>
<li>Once the Director of Studies/Teaching have sent it, disable Google Campaign Tracking then click '''Send''' on the SU page.</li></ol></li></ol>

Debugging:

# If Java throws an error not related to the tool, debug it using your favourite search engine.
# If the only output is <code>var r=null;</code> then you downloaded the wrong report, or set the wrong date range.

=== Via the Director of Studies/Teaching ===

Send an email to Zack Lyons or John Benardis, both are happy to send (relevant) emails to the entire department. Zack is often really busy so John has been more responsive lately. It is worth noting Fabio sends emails targetted at PG-T students.

<ol style="list-style-type: decimal;">
<li>Ensure the email HTML is in your clipboard by running the [[#using-the-templating-system|templator]].</li>
<li>Open [https://outlook.office.com/mail/ Outlook on the Web].</li>
<li>Compose a new email to Zack Lyons. ([mailto:zl221@bath.ac.uk zl221@bath.ac.uk]) or John Benardis ([mailto:ib322@bath.ac.uk ib322@bath.ac.uk]).</li>
<li>Type an introduction just saying hi and asking them to forward the below email to students (specify whether it is for UG, PG-T or PG-R).</li>
<li>Where you want the email to go, type the word “test”.</li>
<li>Hold shift and right-click the word “test”.</li>
<li>Click “inspect”. You should see something like this:
[[File:events-html.png|HTML code, highlighting “div” with class “elementToProof”]]
</li>
<li>Right-click anywhere in the blue highlighted area (text “elementToProof”) and select “Edit as HTML”.</li>
<li>Select the entire textbox and paste (replacing the existing content).</li>
<li>Send the email.</li>
<li>After the email has been forwarded to relevant students, make sure to click send on the SU page!</li></ol>

== Discord ==

== Instagram ==

{{Note|text=This section is a work in progress.}}

* Make sure that any Instagram posts have alt-text and a useful caption. Make sure that all information in the photo is duplicated in the caption.

== WhatsApp ==