User Manual

Complete guide to using the Poker Tournament Import plugin

1. Installation

Get the plugin installed on your WordPress site

AMethod 1: WordPress Admin (Recommended)

  1. Visit WordPress Plugin Directory
  2. Click Download to save poker-tournament-import.zip
  3. In WordPress admin, go to Plugins → Add New
  4. Click Upload Plugin
  5. Choose the downloaded .zip file and click Install Now
  6. Click Activate Plugin

BMethod 2: FTP Upload

  1. Extract poker-tournament-import.zip on your computer
  2. Connect to your site via FTP
  3. Upload the poker-tournament-import folder to /wp-content/plugins/
  4. In WordPress admin, go to Plugins
  5. Find "Poker Tournament Import" and click Activate

Initial Setup

After activation, you'll see a new "Poker Import" menu in your WordPress admin. The setup wizard will guide you through basic configuration.

2. Your First Tournament Import

Import your first tournament from Tournament Director

Step 1: Export from Tournament Director

  1. Open Tournament Director software
  2. Load the tournament you want to publish
  3. Go to File → Export → Tournament Data
  4. Choose JavaScript (.tdt) format
  5. Save the file to your computer

Step 2: Import to WordPress

  1. In WordPress admin, go to Poker Import → Import Tournament
  2. Click Choose File or drag and drop your .tdt file
  3. Review the parsed tournament information
  4. Configure import options:
    • Publish Status: Publish, Draft, or Private
    • Tournament Series: Create new or select existing
    • Player Profiles: Create new players or link existing
  5. Click Import Tournament
  6. Wait for processing (10-30 seconds)
  7. Click View Tournament to see published results

Success!

Your tournament is now published with automatic player profiles, statistics, and rankings. Results are immediately visible to site visitors.

3. Managing Tournaments

View, edit, and organize your tournaments

Viewing All Tournaments

Go to Poker Import → All Tournaments to see:

  • • Tournament name and date
  • • Number of players
  • • Current status (Published/Draft/Private)
  • • Quick actions (Edit/View/Delete)

Editing Tournament Information

  1. Hover over a tournament in the list
  2. Click Edit
  3. Modify tournament details, description, or featured image
  4. Click Update to save changes

Updating Tournament Results

If you need to correct tournament data:

  • Best Method: Re-import the corrected .tdt file
  • Manual Method: Edit individual player results in the tournament edit screen

Tournament Status Options

  • Published: Visible to all website visitors
  • Draft: Not visible to public, can be previewed
  • Private: Only visible to administrators

4. Player Management

Manage player profiles and statistics

The plugin automatically creates player profiles when you import tournaments. Each player gets:

Complete tournament history
Lifetime statistics and achievements
Best finishes and biggest winnings
ROI analytics and net profit tracking

Viewing Player Profiles

  1. Go to Poker Import → Players
  2. Browse the player directory or search for specific players
  3. Click any player name to view their complete profile

Player Statistics

Each player profile includes:

  • • Total Tournaments: Events played
  • • Total Winnings: Career earnings
  • • Average Finish: Typical finishing position
  • • Best Finish: Highest placement
  • • Cashes: Times finishing in the money
  • • Wins: Tournament victories

Editing Player Details

  1. Go to Poker Import → Players
  2. Find the player and click Edit
  3. Update display name, profile picture, bio, or contact information
  4. Click Update to save changes

5. Series & Seasons

Organize tournaments into series and seasons

Tournament Series

Series are related events that are part of a larger competition:

  • • Examples: "Summer Championship Series," "Weekly Thursday Tournament"
  • • Share common branding and structure
  • • Have series-wide standings and prizes

Seasons

Seasons are time-based groupings (typically yearly):

  • • Examples: "2024 Season," "Fall 2023"
  • • Help track annual statistics and rankings
  • • Useful for yearly awards and recognition

Creating a Tournament Series

  1. Go to Poker Import → Series
  2. Click Add New Series
  3. Enter series name, description, and dates
  4. Add series rules and prize information
  5. Click Publish

Alternatively, create a series during tournament import by selecting "Create New Series."

Series Standings

The plugin automatically calculates series standings based on:

  • • Points earned across all series tournaments
  • • Total winnings in series events
  • • Number of tournaments played (consistency)

6. Displaying Results

Show tournament results on your website

Tournament results are displayed automatically on dedicated pages:

/tournaments/tournament-name/

Individual Tournaments

/tournaments/

Tournament Archive

/tournament-series/series-name/

Series Pages

/players/player-name/

Player Profiles

Adding to Navigation Menus

  1. Go to Appearance → Menus
  2. Add tournament pages to your menu
  3. Use "Tournaments" for the archive page
  4. Add specific tournaments or series as needed

7. Shortcodes Reference

Display tournament data anywhere on your site

[tournament_results id="123"]

Display specific tournament results

Options: show_details="yes" | show_players="yes" | show_statistics="yes"
[tournament_series id="456"]

Show all tournaments in a series with standings and overall results

[player_profile name="John Doe"]

Display a player's tournament history and statistics

[poker_tournaments limit="10"]

Show your most recent tournaments in a list format

[poker_leaderboard season="2024" limit="25"]

Show the top players for a specific season or all-time

[series_tabs id="123"]

Complete tabbed interface with overview, results, statistics, and players

[season_tabs id="456"]

Complete tabbed interface for seasons with automatic calculations

8. Customization

Customize colors, styles, and appearance

Colors and Branding

  1. Go to Poker Import → Settings → Display
  2. Customize primary color, secondary color, and font styles
  3. Upload your venue or league logo
  4. Click Save Changes

Custom CSS

Add custom CSS to override default styles:

  1. Go to Appearance → Customize → Additional CSS
  2. Add your custom styles
  3. Click Publish

Example CSS:

/* Change tournament title color */
.tournament-title {
  color: #your-color-hex;
}

/* Adjust results table styling */
.tournament-results-table {
  border: 2px solid #your-color-hex;
}

9. Troubleshooting

Solutions for common issues

"Invalid File Format" Error

Solutions:

  • • Ensure you're exporting from Tournament Director as JavaScript (.tdt)
  • • Check that the file hasn't been renamed or corrupted
  • • Try re-exporting the file from Tournament Director
  • • Verify file size is under 10MB

"Upload Failed" Error

Solutions:

  1. Check PHP upload limits in Poker Import → System Info
  2. Contact your hosting provider to increase upload_max_filesize if needed
  3. Try a different browser or clear browser cache

Shortcode Not Working

Common fixes:

  • • Verify correct shortcode syntax (check for extra spaces or quotes)
  • • Ensure tournament ID is correct
  • • Make sure you're using the Text editor, not Visual editor
  • • Test with a different shortcode to verify plugin is working

Slow Loading Times

Optimization tips:

  • • Enable caching in Poker Import → Settings → Performance
  • • Limit number of tournaments shown per page
  • • Use pagination for large player lists
  • • Optimize images if using player photos

10. Frequently Asked Questions

Quick answers to common questions

Can I import tournaments from other poker software?

Currently, the plugin only supports Tournament Director (.tdt) files. Support for other formats may be added in future versions.

How many tournaments can I store?

There's no built-in limit. You can store thousands of tournaments, though performance may vary based on your hosting plan.

Can I export my tournament data?

Yes, you can export tournament data in CSV format from the admin dashboard.

Is the plugin mobile-friendly?

Yes, all tournament displays are fully responsive and work on all devices.

Can I edit tournament results after importing?

Yes, you can manually edit player results, positions, and winnings. The plugin will automatically recalculate statistics.

What happens if I import the same tournament twice?

The plugin will warn you about duplicates and let you choose whether to update the existing tournament or create a new one.

Can I use this plugin with any WordPress theme?

The plugin is designed to work with any WordPress theme that follows WordPress coding standards.

What are the server requirements?

WordPress 6.0+, PHP 8.0+, and MySQL 5.7+. Most modern hosting plans meet these requirements.

Need More Help?

Support Resources

Documentation