Create certificate of participation — create_participation

Create certificate of participation (1 certificate per DIN-A4 page)

create_participation_certificate(
  data = NULL,
  path = NULL,
  filename = NULL,
  language = c("English", "Spanish"),
  name.column = NULL,
  affiliation.column = NULL,
  comm.type.column = NULL,
  title.column = NULL,
  date.column = NULL,
  email.column = NULL,
  email.info = NULL,
  type = "",
  event = "",
  freetext = "",
  signer = "",
  signer.role = "",
  signature.pic = NULL,
  lpic = NULL,
  rpic = NULL,
  keep.files = FALSE,
  template = NULL
)

Arguments

data: A data frame containing participants' names and contributions.
path: path Character. Path to folder where the PDF certificates will be saved.
filename: Character. Filename of the pdf. If NULL, default is "Participation" for English, "Participacion" for Spanish".
language: Character. Select 'English' or 'Spanish'.
name.column: Character. Name of the column in data storing participants' name.
affiliation.column: Character (optional). Name of the column in data storing participants' affiliation
comm.type.column: Character. Name of the column in data reporting participation type (e.g. poster, oral communication, etc)
title.column: Character. Name of the column in data storing the title of the contribution.
date.column: Character. Name of the column in data storing dates of participation.
email.column: Character. Name of the column in data storing attendees' email address to automatically send them their certificates.
email.info: Object created using configure_email() function.
type: Character (optional). Type of event (conference, workshop, seminar...)
event: Character. Title of the event
freetext: Character (optional). Free text to insert before the date. Can include LaTeX commands (see examples).
signer: Character. Person who signs the certificate
signer.role: Character. Signer's role or position
signature.pic: Character (optional) Path to a PNG image to appear in the bottom, above signer's name.
lpic: Character (optional) Path to a PNG image to appear in the top-left.
rpic: Character (optional) Path to a PNG image to appear in the top-right.
keep.files: Logical. Keep the RMarkdown template and associated files in the output folder? Default is FALSE.
template: Character (optional) RMarkdown template to use. If not provided, using the default template included in labeleR.

Value

PDF certificates are saved on disk, in the folder defined by path. If keep.files = TRUE, the RMarkdown template and PNG logo files will also appear in the same folder.

Author

Ignacio Ramos-Gutierrez, Julia G. de Aledo, Francisco Rodriguez-Sanchez

Examples

if (FALSE) { # interactive()
create_participation_certificate(
  data = participation.table,
  path = "labeleR_output",
  language = "Spanish",
  name.column = "Name",
  affiliation.column = "House",
  comm.type.column = "Comm.type",
  title.column = "Title",
  date.column = "Date",
  type = "online seminar",
  event = "Hogwarts School of Witchcraft and Wizardry",
  freetext = "which lasted 2 hours",
  signer = "A.P.W.B. Dumbledore",
  signer.role = "School Headmaster",
  lpic = NULL,
  rpic = NULL,
  signature.pic = NULL
)
}