Create certificate of 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,
  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.

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
)
}