WedLinker is your essential desktop app for managing wedding-related contacts, designed specifically for professional wedding planners. With a powerful Command Line Interface (CLI), WedLinker is optimised for fast typers, simplifying your contact management tasks through quick, text-based commands. This means you can accomplish your tasks faster than with traditional GUI apps, giving you more time to focus on what matters most—creating memorable experiences for your clients.
While WedLinker excels with its CLI for speed, it still offers the valuable visual elements of a Graphical User Interface (GUI). The GUI provides an organised and intuitive layout, making it easy to visualise your contacts, weddings, and tasks at a glance. This combination of efficiency and clarity ensures that you can manage your wedding planning responsibilities with ease and precision.
Ensure you have Java 17
or above installed on your computer by performing the following:
Windows:
cmd
and press enterMacOS -- do one of the following:
Terminal
in the search field, then click Terminal, OR/Applications/Utilities
folder, then double-click Terminal.java -version
and press enter C:\Users\UserName>java -version
java version "17.0.12" 2024-07-16 LTS
Java(TM) SE Runtime Environment (build 17.0.12+8-LTS-286)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.12+8-LTS-286, mixed mode, sharing)
If you do not have Java 17 installed, or you are unsure, refer to the guide below.
Java 17
from the official website: https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.htmlDownload the latest version of WedLinker from here. Select WedLinker.jar
to begin the download.
Copy the file to the folder you want to use as the home folder for your WedLinker.
Open WedLinker by double clicking the program file, WedLinker.jar
.
A GUI similar to the below should appear in a few seconds. Note how the app contains some sample data.
Type the command in the command box and press Enter to execute it. e.g. typing help
and pressing Enter will open the help window.
Some example commands you can try:
list
: Lists all contacts.
add n/John Doe p/98765432 e/johnd@example.com a/ABC Photography Studio
: Adds a contact named John Doe
to the Address Book.
delete 3
: Deletes the 3rd contact shown in the current list.
clear
: Deletes all contacts.
exit
: Exits the app.
Refer to the Features below for details of each command.
Notes about the command format:
Words in UPPER_CASE
are the parameters to be supplied by the user.
e.g. in add n/NAME
, NAME
is a parameter which can be used as add n/John Doe
.
Items in square brackets are optional.
e.g n/NAME [t/TAG]
can be used as n/John Doe t/guest
or as n/John Doe
.
Items with …
after them can be used multiple times including zero times.
e.g. [t/TAG]…
can be used as (i.e. 0 times),
t/guest
, t/guest t/photographer
etc.
Commands in WedLinker uses prefix to specify the parameters, the prefixes are stated as such:
Parameters can be in any order.
e.g. if the command specifies n/NAME p/PHONE_NUMBER
, p/PHONE_NUMBER n/NAME
is also acceptable.
Extraneous parameters for commands that do not take in parameters (such as help
, list
, exit
and clear
) will be ignored.
e.g. if the command specifies help 123
, it will be interpreted as help
.
If you are using a PDF version of this document, be careful when copying and pasting commands that span multiple lines as space characters surrounding line-breaks may be omitted when copied over to the application.
help
Shows a message explaning how to access the help page.
Format: help
list
Shows a list of all saved Persons in the WedLinker.
Format: list
list-weddings
Shows a list of all Weddings in the WedLinker.
Format: list-weddings
list-tasks
Shows a list of all Tasks in the WedLinker
Format: list-tasks
find
Finds all persons based on the specified keywords (case-insensitive) after the prefix representing the field, and displays them as a list with index numbers.
Format: find PREFIX KEYWORD [KEYWORD]…
hans
will match Hans
.find n/Alex
to search by name, use find e/alex@gmail.com
to search by email.find n/Alex a/
, the search will only look for matches in the name field and ignore the address field.n/Hans n/Bo
will return the same contacts as n/Bo n/Hans
.Examples:
find n/John
returns john
and John Doe
find p/973
returns all Contacts whose phone number contains 973find n/alex n/david
returns Alex Yeoh
, David Li
find t/friends
returns all Contacts tagged with 'guest' find w/Casey's Wedding
returns all Contacts involved with Casey's Wedding clear
Clears all entries from the address book.
Format: clear
Caution: This action is irreversible and cannot be undone. Please ensure you have backed up any important information before proceeding.
exit
Exits the program.
Format: exit
WedLinker data are saved in the hard disk automatically after any command that changes the data. There is no need to save manually.
WedLinker data are saved automatically as a JSON file [JAR file location]/data/WedLinker.json
. Advanced users are welcome to update data directly by editing that data file.
Caution:
If your changes to the data file makes its format invalid, WedLinker will discard all data and start with an empty data file at the next run. Hence, it is recommended to take a backup of the file before editing it.
Furthermore, certain edits can cause the WedLinker to behave in unexpected ways (e.g., if a value entered is outside the acceptable range). Therefore, edit the data file only if you are confident that you can update it correctly.
add
Adds a person to the address book.
Format: add n/NAME [p/PHONE_NUMBER] [e/EMAIL] [a/ADDRESS] [t/TAG]… [w/WEDDING]…
Tip: A person can have any number of tags (including 0)
Examples:
add n/John Doe p/98765432 e/johnd@example.com a/XYZ Floral Services
add n/Betsy Crowe e/betsycrowe@example.com a/ABC Photo Studio p/1234567 t/Photographer
edit
Edits an existing person in the address book.
Format: edit INDEX [n/NAME] [p/PHONE] [e/EMAIL] [a/ADDRESS]
INDEX
. The index refers to the index number shown in the displayed person list. The index must be a positive integer 1, 2, 3, …Examples:
edit 1 p/91234567 e/johndoe@example.com
Edits the phone number and email address of the 1st person to be 91234567
and johndoe@example.com
respectively.edit 2 n/Betsy Crower
Edits the name of the 2nd person to be Betsy Crower
delete
Deletes the specified person from WedLiker.
Format: delete INDEX
INDEX
.Examples:
list
followed by delete 2
deletes the 2nd person in the address book.find n/Betsy
followed by delete 1
deletes the 1st person in the results of the find
command.create-tag
Creates a Tag
within WedLinker to be used on contacts.
Format: create-tag t/TAGNAME
TAGNAME
is alphanumeric and can contain whitespaces.tag
Assigns a Tag
to the specified person in WedLinker
Format: tag INDEX t/TAGNAME [f/]
INDEX
with a Tag
.Tag
must exists in WedLinker before it can be assigned.Tag
does not exist, you can use f/
to force the creation and assignment of the Tag
.untag
Untags a Tag
from a specified person in WedLinker
Format: untag INDEX t/TAGNAME
INDEX
with a Tag
.delete-tag
Deletes a Tag
from WedLinker.
Format: delete-tag t/TAGNAME [f/]
Tag
from WedLinker.Tag
must exists in WedLinker.Tag
cannot be assigned to any contacts.Tag
is in used, you can use f/
to force the deletion of the Tag
and unassign this tag from all contacts.create-wedding
Creates a Wedding
within WedLinker to be with contacts.
Format: create-wedding w/WEDDINGNAME
WEDDINGNAME
is alphanumeric and can contain whitespaces.assign-wedding
Assigns a contact to a Wedding
.
Format: assign-wedding INDEX w/WEDDINGNAME
Wedding
based on their INDEX
.Wedding
must exists in WedLinker before it can be assigned.Wedding
does not exist, you can use f/
to force the creation and assignment of the Wedding
.edit-wedding
Edits the details of a Wedding
.
Format: edit-wedding INDEX [w/WEDDINGNAME] [a/ADDRESS]
Wedding
at the INDEX when in list-wedding view.unassign-wedding
Unassigns a contact from a Wedding
in WedLinker.
Format: unassign-wedding INDEX w/WEDDINGNAME
Wedding
.delete-wedding
Deletes a Wedding
from WedLinker.
Format: delete-wedding w/WEDDINGNAME [f/]
Wedding
from WedLinker.Wedding
before it is deleted.f/
to force the deletion of the Wedding
and unassign all contacts.create-task
Creates a Task
in WedLinker
Format: create-task tk/TASKDESCRIPTION [REMARKS]
REMARKS
with the format d/YYYY-MM-DD
delete-task
Deletes a Task
from WedLinker
Format: delete-task INDEX
Task
at the INDEX when in list-tasks view.assign-task
Format: assign-task PERSONINDEX TASKINDEX
Task
to a contact.PERSONINDEX
refers to the index of the person shown under the People column.TASKINDEX
refers to the index of the task shown under the Tasks columnunassign-task
Format: unassign-task PERSONINDEX TASKINDEX_OFPERSON
Task
from a contact.PERSONINDEX
is the index of the person shown in the displayed person list.TASKINDEX_OFPERSON
is the index of the task associated with the selected person.mark-task
Format: mark-task TASKINDEX
Task
as completed.unmark-task
Format: unmark-task TASKINDEX
Task
as not completed.Q: How do I transfer my data to another Computer?
A: Install the app in the other computer and overwrite the empty data file it creates with the file that contains the data of your previous WedLinker home folder.
preferences.json
file created by the application before running the application again.help
command (or use the Help
menu, or the keyboard shortcut F1
) again, the original Help Window will remain minimized, and no new Help Window will appear. The remedy is to manually restore the minimized Help Window.Action | Format, Examples |
---|---|
Add | add n/NAME p/PHONE_NUMBER e/EMAIL a/ADDRESS [t/TAG]… e.g., add n/James Ho p/22224444 e/jamesho@example.com a/123, Clementi Rd, 1234665 t/florist |
Assign Wedding | assign-wedding PERSON_INDEX w/WEDDING… or asw PERSON_INDEX w/WEDDING… e.g., asw 2 w/Casey's Wedding w/Wedding August 29th |
Clear | clear |
Create Tag | create-tag t/TAG or ctag t/TAG e.g., create-tag t/photographer |
Create Task | create-task tk/TASK_TYPE TASK_DETAILS or ctask tk/TASK_TYPE TASK_DETAILS e.g., create-task tk/todo Order Wedding Cake create-task tk/event Meet Caterer /from 2024-11-19 /to 2024-11-20 create-task tk/deadline Book Venue /by 2025-02-01 |
Create Wedding | create-wedding w/WEDDING or cw w/WEDDING e.g., cw w/JJ's Wedding |
Delete | delete INDEX e.g., delete 3 |
Delete Tag | delete-tag t/TAG or dtag t/TAG e.g., delete-tag t/photographer |
Delete Task | delete-task INDEX or dtask INDEX e.g., dtask 6 |
Delete Wedding | delete-wedding w/WEDDING or dw w/WEDDING e.g., delete-wedding w/Lav's Wedding |
Edit | edit INDEX [n/NAME] [p/PHONE_NUMBER] [e/EMAIL] [a/ADDRESS] [t/TAG]… e.g., edit 2 n/James Lee e/jameslee@example.com |
Edit Wedding | edit-wedding WEDDING_INDEX [p1/PERSON_INDEX] [p2/PERSON_INDEX] [a/ADDRESS] [d/DATE]… or ew WEDDING_INDEX [p1/PERSON_INDEX] [p2/PERSON_INDEX] [a/ADDRESS] [d/DATE]… e.g., edit-wedding 2 p1/3 a/Jurong Christian Church |
Exit | exit |
Find | find [n/NAME] [p/PHONE_NUMBER] [e/EMAIL] [a/ADDRESS] [t/TAG] [w/WEDDING] e.g., find n/James Jake |
Help | help |
List | list |
List Weddings | list-weddings or lw |
List Tasks | list-tasks or lt |
Tag | tag INDEX [t/TAG]… e.g., tag 2 t/florist t/photographer |
Unassign Wedding | unassign-wedding PERSON_INDEX w/WEDDING… or uw PERSON_INDEX w/WEDDING… e.g., uw 2 w/John's Wedding |
Untag | untag INDEX [t/TAG]… e.g., untag 4 t/available t/chef |